Storyden
Robots

Submit a Robot session message

Queue a message in a Robot session. The session is created when it does not already exist. New sessions use Denbot unless `robotId` selects a custom Robot, which then remains the root Robot for the session. Submission is asynchronous. The response identifies the accepted message and the session stream. Compatible queued messages may later be consumed together by one Robot turn.

POST/robots/sessions

Queue a message in a Robot session. The session is created when it does not already exist. New sessions use Denbot unless robotId selects a custom Robot, which then remains the root Robot for the session.

Submission is asynchronous. The response identifies the accepted message and the session stream. Compatible queued messages may later be consumed together by one Robot turn.

Authorization

storyden-session<token>

In: cookie

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/robots/sessions" \  -H "Content-Type: application/json" \  -d '{    "id": "string",    "messages": [      {}    ]  }'
{
  "streamUrl": "string",
  "sessionId": "cc5lnd2s1s4652adtu50",
  "messageId": "cc5lnd2s1s4652adtu50"
}
Empty
Empty
Empty
Empty
Empty
{
  "type": "string",
  "title": "string",
  "detail": "string",
  "trace_id": "string",
  "metadata": {}
}
Edit on GitHub

Update a robot provider PATCH

Update a Robot model provider configuration. API keys are write-only and are redacted from responses.

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.