Platform API
Limits
Every numeric limit of the Platform API in one place.
The limits marked per account have a default that the Sokko team can
change for you. Read your own values with
GET /account. Every
other limit is fixed.
A size in MB or KB below is binary: 1 MB is 1,048,576 bytes and 1 KB is 1,024 bytes.
| Area | Limit | Value |
|---|---|---|
| Account | Workspaces | 25 by default, per account. The sandbox does not count |
| Account | Agents in one workspace | 2 by default, per account |
| Account | Agents in the whole account | Your plan plus your agent seats (pool.agentsLimit) |
| Account | Platform keys | 20 live keys |
| Account | Key expiry | None, or 1 to 365 days |
| Account | Key name | 1 to 64 characters |
| Account | Return origins for the connect flow | 20 |
| Account | Webhook endpoints | 5 |
| Requests | Request budget | 300 per minute by default, per account |
| Requests | Cost of a GET | 1 |
| Requests | Cost of every other method | 2 (memory search: 1) |
| Requests | Workspace creations | 10 per minute |
| Requests | Open event streams | 20 at once |
| Requests | limit of a list | 1 to 100, default 25 |
| Requests | wait of a message or turn read | 0 to 60 seconds |
| Workspaces | externalId | 1 to 128 characters |
| Workspaces | name | 2 to 80 characters |
| Workspaces | metadata keys | 20 |
| Workspaces | metadata key | 1 to 64 characters |
| Workspaces | metadata value | 500 characters |
| Credits | One transfer | 100 to 1,000,000 cents ($1 to $10,000) |
| Credits | Transfer reason | 1 to 200 characters |
| Credits | Top-up thresholdCents | 1 to 1,000,000 |
| Credits | Top-up amountCents | 100 to 1,000,000 |
| Credits | Top-up monthlyCapCents | 1 to 10,000,000, at least amountCents |
| Credits | Usage range | 92 days, default 30 |
| Credits | Top-up checks for an empty workspace | 1 per minute from its messages |
| Agents | name | 2 to 60 characters, one line |
| Agents | instructions | At most 6,000 characters; exactly 6,000 is accepted |
| Agents | modelId | 200 characters |
| Agents | externalId | 1 to 200 characters |
| Agents | skills on one agent | 50 names, each 2 to 100 characters |
| Agents | mcpServers on one agent | 50 names, each 1 to 100 characters |
| Agents | Time for a recipe setup | 15 minutes |
| Agents | Time for an upgrade | 15 minutes |
| Skills and MCP servers | Skill name | 1 to 120 characters; its slug is cut at 64 |
| Skills and MCP servers | Skill version | 1 to 80 characters |
| Skills and MCP servers | Files in one skill | 200 |
| Skills and MCP servers | Size of one skill | 5 MB, decoded |
| Skills and MCP servers | File path in a skill | 500 characters |
| Skills and MCP servers | MCP server name | 64 characters |
| Skills and MCP servers | MCP server url | 2,048 characters; port 443 or 80; https for a token server of an end_users agent |
| Skills and MCP servers | MCP server token | 8,192 characters |
| Skills and MCP servers | MCP header name | 64 characters |
| Skills and MCP servers | MCP server description | 2,000 characters |
| Memory | Search query | 500 characters |
| Memory | Search limit | 1 to 50, default 20 |
| Memory | One fact | 20,000 characters |
| Memory | Files in one import | 200 |
| Memory | One imported file | 262,144 characters |
| Memory | Import filename | 256 characters |
| Conversations | externalUserId | 1 to 128 characters |
| Conversations | Conversation title | 1 to 120 characters, one line |
| Conversations | Message text | 32,000 characters |
| Conversations | Message body | 160,000 bytes |
| Conversations | Turns at once in one conversation | 1 |
| Conversations | Length of one turn | 30 minutes |
| Conversations | answers in one message | 20 |
| Conversations | optionIds in one answer | 4 |
| Conversations | Attachments in one message | 5 files, 20 MB together |
| Conversations | One attachment | 5 MB |
| Conversations | Pages in a PDF attachment | 50 |
| Conversations | Attachments in one conversation | 2,000 files, 200 MB together |
| Conversations | Stream keepalive | Every 15 seconds |
| Conversations | Stream reconnect delay | 3 seconds |
| Conversations | Wait for a turn to stop, in an end-user delete | 5 seconds |
| Webhooks | Endpoint url | 2,048 characters, https |
| Webhooks | Time to answer a delivery | 10 seconds |
| Webhooks | Attempts per delivery | 7 |
| Webhooks | Waits between attempts | 1 min, 5 min, 30 min, 2 h, 6 h, 12 h |
| Webhooks | Failed attempts before disable | 20 in a row, over all deliveries of the endpoint |
| Webhooks | Deliveries to one endpoint in one batch | 2 |
| Webhooks | Signature time tolerance | 5 minutes |
| Webhooks | Deliveries in the delivery list | The last 50 |
| Webhooks | Delivery records kept | 7 days when delivered, 30 days when failed |
| Schedules | Schedule name | 1 to 80 characters, not starting with [ |
| Schedules | Schedule prompt | 4,000 characters |
| Schedules | cron | Five fields, 120 characters |
| Schedules | timezone | 100 characters |
| Recipes | Recipe slug | 63 characters |
| Recipes | Recipe name | 1 to 120 characters |
| Recipes | Recipe description | 2,000 characters |
| Recipes | One spec | 512 KB of JSON |
| Recipes | agent.name template | 200 characters; rendered 2 to 60 |
| Recipes | instructions | At most 6,000 characters, as template and rendered |
| Recipes | Variables | 20 |
| Recipes | Variable name | 40 characters |
| Recipes | text value | 200 characters, one line |
| Recipes | block value | 2,000 characters, 40 lines kept |
| Recipes | block placeholder in the length check | 2,193 characters |
| Recipes | Skills | 20, 25 MB together |
| Recipes | MCP servers | 10 |
| Recipes | Integrations | 20; label 1 to 60 characters |
| Recipes | Schedules | 10; name 1 to 80 characters, not starting with [ |
| Recipes | Memory files | 20, 64 KB each |
| Recipes | Memory facts | 50, 2,000 characters each |
| Recipes | Tests | 10 |
| Recipes | Test name | 1 to 80 characters |
| Recipes | Test prompt | 4,000 characters |
| Recipes | Test timeoutSeconds | 30 to 600, default 180 |
| Test runs | Runs at once | 1 per account |
| Test runs | Runs that wait | 5 |
| Test runs | Time for the test agent to be ready | 10 minutes |
| Test runs | Time for a whole run | 45 minutes |
| Test runs | Stored answer of one test | 64 KB |
| Test runs | Stored tool calls of one test | 200 |
| Connect flow | Life of a connect link | About 10 minutes |
| Connect flow | returnUrl | 2,000 characters, https |
| Connect flow | Connection label | 1 to 60 characters |
| Connect flow | App search | 64 characters |