v1

latestOpenAPI 3.1.02026-08-04156223229.6 KB
agent-loop

Create Turn

Write-ahead: create a pending turn before agent starts running.

post/agent-loop/workspaces/{workspace_id}/turns

Path parameters

workspace_idstring required

Request body

idstring nullable
parent_idstring nullable
user_messagestring nullable
user_idstring nullable
artifact_contextstring[]
parent_snapshot_idstring nullable

Response

Successful Response

idstring required
handoff_codestring required

Single-use code redeemable at /agent-loop/internal/agent-token/redeem for the agent-svc JWT bound to this turn. 60s TTL.