Skip to main content
POST
Python

Authorizations

x-api-key
string
header
required

API key for authentication

Headers

Idempotency-Key
string

Retry key scoped to the authenticated tenant and principal. Required and non-blank for every delta_v1 request; optional for legacy_full.

Required string length: 1 - 256

Body

application/json
input
object
required

Agent run input. legacy_full accepts a complete AG-UI history; delta_v1 accepts only the newest user turn and lets the server rebuild a bounded rolling context.

Response

Agent run accepted

run_id
string
required
thread_id
string
required
workflow_type
string
required
provider
enum<string>
required
Available options:
ANTHROPIC_DIRECT,
BEDROCK,
OPENAI,
VERTEX_AI
execution_mode
enum<string>
required
Available options:
LOCAL,
AGENTCORE
status
enum<string>
required

Agent run lifecycle state.

Available options:
QUEUED,
RUNNING,
CANCELLING,
SUCCEEDED,
FAILED,
CANCELLED
input_history_mode
enum<string>
required

How the request supplied conversation history for this run.

Available options:
legacy_full,
delta_v1
context_start_run_id
string | null
required

Oldest run included in the reconstructed rolling context, or null when none was needed.

context_truncated
boolean
required

Whether older turns were omitted to stay within the server context budget.

runtime_arn
string | null
mcp_session_id
string | null
trace_id
string | null

保存済みW3C trace contextから導出したlowercase OpenTelemetry trace ID。移行前の行はnull。

Pattern: ^[0-9a-f]{32}$
Example:

"4bf92f3577b34da6a3ce929d0e0e4736"

idempotency_key
string | null
created_at
string<date-time> | null
started_at
string<date-time> | null
finished_at
string<date-time> | null
input
object | null

Server-enriched agent input used to reconstruct the thread transcript.

parent_run_id
string | null

Run this run branched from within the thread (null for the thread root).

result
object | null
error
object | null