Skip to main content
POST
Create workflows handoffs

Authorizations

Authorization
string
header
required

Organization-scoped EvalGate API key. Discover the supported agent scopes at /.well-known/oauth-protected-resource. Per-operation grants are listed in x-evalgate-required-scopes; OpenAPI bearer security requirement arrays remain empty as required for non-OAuth schemes.

Path Parameters

id
integer
required

Body

application/json
workflowRunId
number
required
toSpanId
string
required
toAgent
string
required
handoffType
required
Available options:
fallback
context
object
fromSpanId
string
fromAgent
string

Response

Successful response

id
number
required
organizationId
string<uuid>
required
workflowRunId
null | number
required
context
null | object
required
fromSpanId
null | string
required
toSpanId
string
required
fromAgent
null | string
required
toAgent
string
required
handoffType
string
required
timestamp
string<date-time>
required