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

templateId
string<uuid>
required

Email template ID.

Body

application/json
prompt
string
required

What to change.

Required string length: 1 - 10000
asset_ids
string[]

Template asset IDs to reference.

Response

Iteration queued.

template_id
string<uuid>
required

Email template ID.

generation_id
string
required

Generation to poll via GET /v1/email-templates/{templateId}/generations/{generationId}.

status
string
required

Always generating on acceptance.

message_id
string

Chat message recorded for the prompt.