Skip to main content
POST
Create

Authorizations

Authorization
string
header
required

A personal API key (adside_pat_…) or a token from adside login. Either carries the permissions of the person it belongs to.

Path Parameters

workspaceId
string
required
Minimum string length: 1

Body

application/json
requestId
string
required
Required string length: 1 - 200
prompt
string
required
Required string length: 1 - 10000
creativeCount
integer

Exact quantity, overriding the prompt. Omit for Auto: infer from the prompt, or use 5 when unspecified.

Required range: 1 <= x <= 30
references
object[]
Maximum array length: 20

Response

201 - application/json

Success

New creation returns a conversation receipt with runId null until reservation. Follow message events or recover by requestId, then poll the accepted run. Historical create retries retain their production run receipt.

dropId
string
required
Required string length: 1 - 300
messageId
string
required
Required string length: 1 - 300
requestId
string
required
Required string length: 1 - 200
delivery
enum<string>
required
Available options:
pending,
active,
held,
completed
runId
string | null
required
Required string length: 1 - 300
feedbackStatus
enum<string>
Available options:
queued,
received,
uncertain,
addressed,
needs-input
feedbackReason
string
waitingForBrandKit
boolean