> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Creatives

> The 21 adside commands for Creatives.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside creatives --help` to see what your installed version has.

## creatives

### creatives add

Add new creatives to an existing drop, or attach to the active drop-chat turn.

Beta: this command may still change.

```bash theme={null}
adside creatives add --drop-id <id> --instruction <instruction> --creative-count <1-30> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--drop-id` (required) | `<id>` | |
| `--instruction` (required) | `<instruction>` | |
| `--creative-count` (required) | `<1-30>` | |
| `--request-id` | `<id>` | Submission identity (generated automatically if omitted) |
| `--references` | `'<json>'` | |
| `--reference-file` (repeatable) | `<file>` | Upload a local image, video or .zip as a creative reference (repeatable) |
| `--wait` | | Wait for the run to end and print it; on a busy drop, wait for its turn first (same request ID, never a second run) |
| `--wait-timeout` | `<duration>` | How long --wait may take: 90s, 14m or seconds (default 30m) |

### creatives by-request-id

Recover the exact receipt of a create request without resubmitting.

Beta: this command may still change.

```bash theme={null}
adside creatives by-request-id --request-id <id>
```

### creatives cancel

Request cancellation of an exact run, retaining published work.

Beta: this command may still change.

```bash theme={null}
adside creatives cancel --drop-id <id> --run-id <id>
```

### creatives copy

Save export copy against an exact creative revision.

Beta: this command may still change.

```bash theme={null}
adside creatives copy --drop-id <id> --creative-id <id> --base-creative-revision-id <id> --copy '<json>'
```

### creatives create

Start a creative drop; the sandbox reserves and generates its first batch.

Beta: this command may still change.

```bash theme={null}
adside creatives create --prompt <prompt> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--prompt` (required) | `<prompt>` | |
| `--request-id` | `<id>` | Submission identity (generated automatically if omitted) |
| `--creative-count` | `<1-30>` | Exact quantity, overriding the prompt. Omit for Auto: infer from the prompt, or use 5 when unspecified. |
| `--references` | `'<json>'` | |
| `--reference-file` (repeatable) | `<file>` | Upload a local image, video or .zip as a creative reference (repeatable) |
| `--wait` | | Wait for the run to end and print it; on a busy drop, wait for its turn first (same request ID, never a second run) |
| `--wait-timeout` | `<duration>` | How long --wait may take: 90s, 14m or seconds (default 30m) |

### creatives edit

Edit exact creative IDs, numbers or explicit all, using the active drop-chat turn when called from its resident.

Beta: this command may still change.

```bash theme={null}
adside creatives edit --drop-id <id> --instruction <instruction> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--drop-id` (required) | `<id>` | |
| `--instruction` (required) | `<instruction>` | |
| `--request-id` | `<id>` | Submission identity (generated automatically if omitted) |
| `--references` | `'<json>'` | |
| `--expected-creative-revision-ids` | `'<json>'` | |
| `--format-adaptation` | `'<json>'` | |
| `--target-creative-ids` | `'<json>'` | |
| `--target-creative-numbers` | `'<json>'` | |
| `--all-creatives` | `true\|false` | |
| `--reference-file` (repeatable) | `<file>` | Upload a local image, video or .zip as a creative reference (repeatable) |
| `--wait` | | Wait for the run to end and print it; on a busy drop, wait for its turn first (same request ID, never a second run) |
| `--wait-timeout` | `<duration>` | How long --wait may take: 90s, 14m or seconds (default 30m) |

### creatives get

Read stable creative IDs, numbers and current render revisions.

Beta: this command may still change.

```bash theme={null}
adside creatives get --drop-id <id>
```

### creatives list

List creative drops and their current rendered previews.

Beta: this command may still change.

```bash theme={null}
adside creatives list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--offset` | `<0-100000>=0` | The next page, from the previous output. |
| `--query` | `<query>` | |

### creatives revert

Restore a creative revision without changing other creatives.

Beta: this command may still change.

```bash theme={null}
adside creatives revert --drop-id <id> --creative-id <id> --creative-revision-id <id> --expected-creative-revision-id <id>
```

### creatives review

Select or discard a creative for campaigns.

Beta: this command may still change.

```bash theme={null}
adside creatives review --drop-id <id> --creative-id <id> --review-status unreviewed|kept|discarded
```

### creatives status

Read an exact run's progress, terminal result and cleanup state.

Beta: this command may still change.

```bash theme={null}
adside creatives status --drop-id <id> --run-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--drop-id` (required) | `<id>` | |
| `--run-id` (required) | `<id>` | |
| `--wait` | | Wait for the run to end and print it; on a busy drop, wait for its turn first (same request ID, never a second run) |
| `--wait-timeout` | `<duration>` | How long --wait may take: 90s, 14m or seconds (default 30m) |

## creatives comments

### creatives comments create

Pin feedback to a creative revision.

Beta: this command may still change.

```bash theme={null}
adside creatives comments create --drop-id <id> --creative-id <id> --creative-revision-id <id> --target '<json>' --body <body>
```

### creatives comments delete

Remove your unsubmitted creative feedback.

Beta: this command may still change.

```bash theme={null}
adside creatives comments delete --drop-id <id> --comment-id <id>
```

### creatives comments update

Update your unsubmitted creative feedback.

Beta: this command may still change.

```bash theme={null}
adside creatives comments update --drop-id <id> --comment-id <id> --body <body>
```

## creatives messages

### creatives messages create

Send a live drop conversation input.

Beta: this command may still change.

```bash theme={null}
adside creatives messages create --drop-id <id> --instruction <instruction> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--drop-id` (required) | `<id>` | |
| `--instruction` (required) | `<instruction>` | |
| `--feedback-only` | `true\|false` | |
| `--request-id` | `<id>` | Submission identity (generated automatically if omitted) |
| `--references` | `'<json>'` | |
| `--expected-creative-revision-ids` | `'<json>'` | |
| `--format-adaptation` | `'<json>'` | |
| `--targets` | `'<json>'` | |
| `--comment-ids` | `'<json>'` | |
| `--reference-file` (repeatable) | `<file>` | Upload a local image, video or .zip as a creative reference (repeatable) |

### creatives messages list

Read the shared drop conversation.

Beta: this command may still change.

```bash theme={null}
adside creatives messages list --drop-id <id>
```

### creatives messages resume

Explicitly resume a held conversation input.

Beta: this command may still change.

```bash theme={null}
adside creatives messages resume --drop-id <id> --message-id <id>
```

### creatives messages stop

Stop an exact conversation input.

Beta: this command may still change.

```bash theme={null}
adside creatives messages stop --drop-id <id> --message-id <id>
```

## creatives meta

### creatives meta prepare

Check exact static creative revisions and missing formats for a Meta ad set; never generates or publishes.

Beta: this command may still change.

```bash theme={null}
adside creatives meta prepare --drop-id <id> --adset-id <id> --creative-ids '<json>'
```

## creatives revisions

### creatives revisions get

Read a historical creative revision and its published media and copy.

Beta: this command may still change.

```bash theme={null}
adside creatives revisions get --drop-id <id> --creative-id <id> --creative-revision-id <id>
```

## creatives runs

### creatives runs by-request-id

Recover the exact receipt of an edit request without resubmitting.

Beta: this command may still change.

```bash theme={null}
adside creatives runs by-request-id --drop-id <id> --request-id <id>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.