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

Base URL
https://docs.terminaluse.com (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/terminaluse/apis/sb0-api/docs/raw-events/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Changes

No recorded changes to this operation across all 1 revision of this API.

Publish Raw SDK Event

Request

Request body

Response 200OK

Changes

Response