Storyden
Robots

List robot sessions

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.

GET/robots/sessions

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.

Authorization

storyden-session<token>

In: cookie

Query Parameters

page?string

Pagination query parameters.

account_id?string

Account ID.

Response Body

application/json

application/json

curl -X GET "https://example.com/robots/sessions"
{
  "page_size": 0,
  "results": 0,
  "total_pages": 0,
  "current_page": 0,
  "next_page": 0,
  "sessions": [
    {
      "id": "cc5lnd2s1s4652adtu50",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "deletedAt": "2019-08-24T14:15:22Z",
      "misc": {},
      "name": "string",
      "created_by": {
        "id": "cc5lnd2s1s4652adtu50",
        "joined": "2019-08-24T14:15:22Z",
        "suspended": "2019-08-24T14:15:22Z",
        "handle": "Southclaws",
        "name": "Barnaby Keene",
        "signature": "<body><p>Sent with love from London!</p></body>",
        "roles": [
          {
            "badge": true,
            "default": true,
            "id": "cc5lnd2s1s4652adtu50",
            "name": "string",
            "colour": "string",
            "meta": {}
          }
        ]
      }
    }
  ]
}
Empty
{
  "type": "string",
  "title": "string",
  "detail": "string",
  "trace_id": "string",
  "metadata": {}
}
Edit on GitHub

Get a robot session GET

Retrieve a specific robot session with all of its messages. Sessions can involve interactions with multiple Robots so the Robot is specified on each message. Messages may not be representative of exactly what is sent into a language model, as certain optimisations may be performed before this such as compaction, summarisation or removal of irrelevant context. Any member with "USE_ROBOTS" can see any other members' sessions and messages with a Robot. Robots are not considered private assistants, but rather shared tools for the team to use for managing their community.

Read a Robot session event stream GET

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.