Skip to main content
POST

Authorizations

Authorization
string
header
required

Clé API ret_live_… créée dans Settings → API keys.

Headers

Idempotency-Key
string

Identifiant unique de la demande côté client (ex. UUID). Non vide.

Minimum string length: 1

Body

application/json
prompt
string
required

Consigne en langage naturel. Non vide.

Minimum string length: 1
workspace_id
string

Workspace existant. Sinon un workspace est créé.

conversation_id
string

Continue une conversation (nouveau run dans le même fil).

output
object

Contrat de sortie optionnel. Sans lui, le run renvoie message, artifacts et output: null.

Response

Run accepté.

id
string
workspace_id
string
conversation_id
string
status
enum<string>
Available options:
queued,
running,
recovering,
completed,
failed,
cancelled
message
string | null

Texte final de l'agent.

artifacts
object[]

Tables créées ou modifiées par le run (état vivant).

last_heartbeat_at
string<date-time> | null
progress
object
output
object | null
error
object | null
created_at
string<date-time>
updated_at
string<date-time>
started_at
string<date-time> | null
completed_at
string<date-time> | null
cancellation_requested
boolean