Create a robot
Create a new Robot with the specified configuration. A Robot in Storyden consists of a name and description (for humans) as well as a playbook, and a set of direct tools and reusable Toolsets to interact with Storyden plugins, or connected MCP servers. The playbook is a detailed set of instructions that guides behaviour of the Robot to help it assist members in achieving a specific automation goal. Direct tools support narrowly scoped Robots, while Toolsets bundle tools with optional specialist instructions. Toolsets can be shared across Robots and can come from Storyden, members, plugins, or connected MCP servers.
/robotsCreate a new Robot with the specified configuration. A Robot in Storyden consists of a name and description (for humans) as well as a playbook, and a set of direct tools and reusable Toolsets to interact with Storyden plugins, or connected MCP servers. The playbook is a detailed set of instructions that guides behaviour of the Robot to help it assist members in achieving a specific automation goal. Direct tools support narrowly scoped Robots, while Toolsets bundle tools with optional specialist instructions. Toolsets can be shared across Robots and can come from Storyden, members, plugins, or connected MCP servers.
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" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "description": "string", "playbook": "string" }'{
"id": "cc5lnd2s1s4652adtu50",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z",
"misc": {},
"name": "string",
"description": "string",
"playbook": "string",
"model": "openai/gpt-4.1-mini",
"workspace_id": "cc5lnd2s1s4652adtu50",
"author": {
"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": {}
}
]
},
"tools": [
"string"
],
"toolsets": [
"string"
],
"meta": {}
}{
"type": "string",
"title": "string",
"detail": "string",
"trace_id": "string",
"metadata": {}
}