Creatives

See Using commands for how flags, JSON input, paging and confirmations work. Run adside creatives --help to see what your installed version has.

creatives add

Add new creatives to an existing drop, or attach to the active drop-chat turn. Beta: this command may still change.

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.

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.

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.

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.

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.

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.

adside creatives get --drop-id <id>

creatives list

List creative drops and their current rendered previews. Beta: this command may still change.

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.

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.

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.

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.

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.

adside creatives comments delete --drop-id <id> --comment-id <id>

creatives comments update

Update your unsubmitted creative feedback. Beta: this command may still change.

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.

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.

adside creatives messages list --drop-id <id>

creatives messages resume

Explicitly resume a held conversation input. Beta: this command may still change.

adside creatives messages resume --drop-id <id> --message-id <id>

creatives messages stop

Stop an exact conversation input. Beta: this command may still change.

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.

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.

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.

adside creatives runs by-request-id --drop-id <id> --request-id <id>

CLI

Command reference

Creatives

creatives

creatives add

creatives by-request-id

creatives cancel

creatives copy

creatives create

creatives edit

creatives get

creatives list

creatives revert

creatives review

creatives status

creatives comments

creatives comments create

creatives comments delete

creatives comments update

creatives messages

creatives messages create

creatives messages list

creatives messages resume

creatives messages stop

creatives meta

creatives meta prepare

creatives revisions

creatives revisions get

creatives runs

creatives runs by-request-id

​creatives

​creatives add

​creatives by-request-id

​creatives cancel

​creatives copy

​creatives create

​creatives edit

​creatives get

​creatives list

​creatives revert

​creatives review

​creatives status

​creatives comments

​creatives comments create

​creatives comments delete

​creatives comments update

​creatives messages

​creatives messages create

​creatives messages list

​creatives messages resume

​creatives messages stop

​creatives meta

​creatives meta prepare

​creatives revisions

​creatives revisions get

​creatives runs

​creatives runs by-request-id

creatives

creatives add

creatives by-request-id

creatives cancel

creatives copy

creatives create

creatives edit

creatives get

creatives list

creatives revert

creatives review

creatives status

creatives comments

creatives comments create

creatives comments delete

creatives comments update

creatives messages

creatives messages create

creatives messages list

creatives messages resume

creatives messages stop

creatives meta

creatives meta prepare

creatives revisions

creatives revisions get

creatives runs

creatives runs by-request-id