v1

latestOpenAPI 3.1.02026-08-04151221521.2 KB
Raw Events

Publish Raw SDK Event

Publish a raw SDK event for transformation and streaming.

This endpoint replaces the deprecated `/stream-events` endpoint.
Events are transformed via SDK-specific adapters (based on `sdk_type` and `sdk_version`)
and the resulting stream parts are published to Redis for real-time consumption.

Messages that should be stored (e.g., AssistantMessage, UserMessage) are
automatically persisted to MongoDB for later retrieval.

**Supported SDK Types:**
- `claude`: Claude Agent SDK messages (StreamEvent, AssistantMessage, etc.)
- `codex`: Codex SDK thread events (`item.*`, `turn.*`, `thread.*`)
- `terminal_use`: Direct UIMessage format (Vercel-compatible)

**What gets stored:**
- AssistantMessage, UserMessage, ResultMessage, SystemMessage

**What does NOT get stored:**
- StreamEvent (ephemeral streaming deltas)

Requires `update` permission on the task.
post/raw-events

Request body

idempotency_keystring nullable

Optional idempotency key for request-level deduplication

raw_eventobject required

The raw SDK event payload

sdk_typestring required

SDK type identifier (e.g., 'claude', 'codex', 'terminal_use')

sdk_versionstring required

SDK version in semver format (e.g., '0.1.22')

task_idstring required

Task ID to publish the event to

Response

Successful Response

published_countinteger required

Number of stream parts published to Redis

storedboolean required

Whether the message was persisted to storage