Cloud and BYOC for Orca Agent Engine are in Private Preview — request an invite
Docs
Sessions

Sessions.append events

POST/v1/sessions/{id}/events
x-api-key<token>

Workspace API key. Read from the x-api-key header by src/auth/api-key.ts. A key that is present and does not authenticate is final — no other scheme is consulted.

In: header

Path Parameters

id*string
Match^(?:ses|sesn)_[A-Za-z0-9_-]+$

Header Parameters

idempotency-key?string
orca-beta?string
anthropic-beta?string

Accepted for Anthropic SDK compatibility and ignored. No value of this header changes request handling. Typed as a free-form string rather than an enum because this service recognises no specific beta value.

Request Body

application/json

Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/sessions/string/events" \  -H "Content-Type: application/json" \  -d '{    "events": [      {        "type": "user.message",        "content": [          {            "type": "text",            "text": "string"          }        ]      }    ]  }'
{  "data": [    {      "id": "string",      "type": "string",      "processed_at": "2019-08-24T14:15:22Z"    }  ]}