Storyden
Robots

Read a Robot session event stream

Read persisted events after an offset and optionally remain attached to the live session tail. The stream remains open while the session is idle so turns started by other members or background work are observable.

GET
/robots/sessions/{session_id}/stream

Read persisted events after an offset and optionally remain attached to the live session tail. The stream remains open while the session is idle so turns started by other members or background work are observable.

Authorization

cookiestoryden-session<token>

Path Parameters

session_id*string

Robot session ID

Formatxid

Query Parameters

offset?string

Read events after this stream offset. Use -1 to start at beginning.

Default"-1"
live?"sse"

Attach to the live stream tail after catching up.

Value in"sse"

Response Body

Persisted Robot session events, optionally followed by a live SSE tail.

  1. response
[index: integer]?
Example Request
curl -X GET 'https://example.com/api/robots/sessions/string/stream'
Example Response
[  {    "sequence": 0,    "turn_id": "string",    "input_ids": [      "string"    ],    "event_kind": "message",    "message": {      "id": "string",      "role": "system",      "parts": [        {          "type": "text",          "text": "string",          "state": "streaming"        }      ],      "metadata": {},      "created_at": "2019-08-24T14:15:22Z",      "queued": true,      "assets": [        {          "id": "string",          "filename": "string",          "path": "string",          "mime_type": "string",          "width": 0,          "height": 0,          "parent": {}        }      ],      "robot": {        "id": "string",        "name": "string"      },      "author": {        "id": "string",        "joined": "2019-08-24T14:15:22Z",        "suspended": "2019-08-24T14:15:22Z",        "handle": "string",        "name": "string",        "signature": "string",        "roles": [          {            "badge": true,            "default": true,            "id": "string",            "name": "string",            "colour": "string",            "meta": {}          }        ]      },      "branch": "string",      "isolation_scope": "string"    },    "parts": [      {        "type": "start",        "messageId": "string"      }    ]  }]
Edit on GitHub

List robot sessions GET

Get a paginated list of Robot sessions. These are chat sessions with the Robot system. Denbot may delegate work to specialised Robots inside the same session. Delegated events retain their ADK branch and isolation scope so the execution tree remains inspectable. You may include an account ID to filter sessions by account. Only those with "USE_ROBOTS" permission can use Robots, however sessions, messages and usage is not considered hidden to other accounts with the usage permission. Robots are intended as administrative or moderation tools to be shared among the team rather than private assistants.

Inspect a Robot session event stream HEAD

Inspect the session event stream without reading any events. The supplied offset represents the last event already observed by the caller. The response reports the offset to use for the next read and whether that position is caught up with the stream's current tail. This request returns immediately and does not wait for future events.