---
title: "Publish Raw SDK Event"
method: POST
path: "/raw-events"
tags: ["Raw Events"]
---

# Publish Raw SDK Event

`POST /raw-events`

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.

## Request body

- RawEventPayload — Request payload for publishing a raw SDK event.
  - `idempotency_key` string, nullable — Optional idempotency key for request-level deduplication
  - `raw_event` object, required — The raw SDK event payload
  - `sdk_type` string, required — SDK type identifier (e.g., 'claude', 'codex', 'terminal_use')
  - `sdk_version` string, required — SDK version in semver format (e.g., '0.1.22')
  - `task_id` string, required — Task ID to publish the event to

## Response `200`

Successful Response

- PublishRawEventResponse — Response after publishing a raw event.
  - `published_count` integer, required — Number of stream parts published to Redis
  - `stored` boolean, required — Whether the message was persisted to storage

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)