Skip to main content
POST
Iterate with AI

Authorizations

Authorization
string
header
required

Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.

Headers

Idempotency-Key
string

Optional idempotency key. Replaying a request with the same key returns the stored result of the first attempt. If the first attempt is still in flight, the replay fails with 409 idempotency_in_progress.

Path Parameters

emailId
string<uuid>
required

Email ID.

Body

application/json
prompt
string
required

What to change.

Required string length: 1 - 10000
asset_ids
string[]

Email asset IDs to reference.

Response

Iteration queued.

email_id
string<uuid>
required

Email ID.

generation_id
string
required

Generation to poll via GET /v1/emails/{emailId}/generations/{generationId}.

status
string
required

Always generating on acceptance.

message_id
string

Chat message recorded for the prompt.