Sokko Docs
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.

AreaLimitValue
AccountWorkspaces25 by default, per account. The sandbox does not count
AccountAgents in one workspace2 by default, per account
AccountAgents in the whole accountYour plan plus your agent seats (pool.agentsLimit)
AccountPlatform keys20 live keys
AccountKey expiryNone, or 1 to 365 days
AccountKey name1 to 64 characters
AccountReturn origins for the connect flow20
AccountWebhook endpoints5
RequestsRequest budget300 per minute by default, per account
RequestsCost of a GET1
RequestsCost of every other method2 (memory search: 1)
RequestsWorkspace creations10 per minute
RequestsOpen event streams20 at once
Requestslimit of a list1 to 100, default 25
Requestswait of a message or turn read0 to 60 seconds
WorkspacesexternalId1 to 128 characters
Workspacesname2 to 80 characters
Workspacesmetadata keys20
Workspacesmetadata key1 to 64 characters
Workspacesmetadata value500 characters
CreditsOne transfer100 to 1,000,000 cents ($1 to $10,000)
CreditsTransfer reason1 to 200 characters
CreditsTop-up thresholdCents1 to 1,000,000
CreditsTop-up amountCents100 to 1,000,000
CreditsTop-up monthlyCapCents1 to 10,000,000, at least amountCents
CreditsUsage range92 days, default 30
CreditsTop-up checks for an empty workspace1 per minute from its messages
Agentsname2 to 60 characters, one line
AgentsinstructionsAt most 6,000 characters; exactly 6,000 is accepted
AgentsmodelId200 characters
AgentsexternalId1 to 200 characters
Agentsskills on one agent50 names, each 2 to 100 characters
AgentsmcpServers on one agent50 names, each 1 to 100 characters
AgentsTime for a recipe setup15 minutes
AgentsTime for an upgrade15 minutes
Skills and MCP serversSkill name1 to 120 characters; its slug is cut at 64
Skills and MCP serversSkill version1 to 80 characters
Skills and MCP serversFiles in one skill200
Skills and MCP serversSize of one skill5 MB, decoded
Skills and MCP serversFile path in a skill500 characters
Skills and MCP serversMCP server name64 characters
Skills and MCP serversMCP server url2,048 characters; port 443 or 80; https for a token server of an end_users agent
Skills and MCP serversMCP server token8,192 characters
Skills and MCP serversMCP header name64 characters
Skills and MCP serversMCP server description2,000 characters
MemorySearch query500 characters
MemorySearch limit1 to 50, default 20
MemoryOne fact20,000 characters
MemoryFiles in one import200
MemoryOne imported file262,144 characters
MemoryImport filename256 characters
ConversationsexternalUserId1 to 128 characters
ConversationsConversation title1 to 120 characters, one line
ConversationsMessage text32,000 characters
ConversationsMessage body160,000 bytes
ConversationsTurns at once in one conversation1
ConversationsLength of one turn30 minutes
Conversationsanswers in one message20
ConversationsoptionIds in one answer4
ConversationsAttachments in one message5 files, 20 MB together
ConversationsOne attachment5 MB
ConversationsPages in a PDF attachment50
ConversationsAttachments in one conversation2,000 files, 200 MB together
ConversationsStream keepaliveEvery 15 seconds
ConversationsStream reconnect delay3 seconds
ConversationsWait for a turn to stop, in an end-user delete5 seconds
WebhooksEndpoint url2,048 characters, https
WebhooksTime to answer a delivery10 seconds
WebhooksAttempts per delivery7
WebhooksWaits between attempts1 min, 5 min, 30 min, 2 h, 6 h, 12 h
WebhooksFailed attempts before disable20 in a row, over all deliveries of the endpoint
WebhooksDeliveries to one endpoint in one batch2
WebhooksSignature time tolerance5 minutes
WebhooksDeliveries in the delivery listThe last 50
WebhooksDelivery records kept7 days when delivered, 30 days when failed
SchedulesSchedule name1 to 80 characters, not starting with [
SchedulesSchedule prompt4,000 characters
SchedulescronFive fields, 120 characters
Schedulestimezone100 characters
RecipesRecipe slug63 characters
RecipesRecipe name1 to 120 characters
RecipesRecipe description2,000 characters
RecipesOne spec512 KB of JSON
Recipesagent.name template200 characters; rendered 2 to 60
RecipesinstructionsAt most 6,000 characters, as template and rendered
RecipesVariables20
RecipesVariable name40 characters
Recipestext value200 characters, one line
Recipesblock value2,000 characters, 40 lines kept
Recipesblock placeholder in the length check2,193 characters
RecipesSkills20, 25 MB together
RecipesMCP servers10
RecipesIntegrations20; label 1 to 60 characters
RecipesSchedules10; name 1 to 80 characters, not starting with [
RecipesMemory files20, 64 KB each
RecipesMemory facts50, 2,000 characters each
RecipesTests10
RecipesTest name1 to 80 characters
RecipesTest prompt4,000 characters
RecipesTest timeoutSeconds30 to 600, default 180
Test runsRuns at once1 per account
Test runsRuns that wait5
Test runsTime for the test agent to be ready10 minutes
Test runsTime for a whole run45 minutes
Test runsStored answer of one test64 KB
Test runsStored tool calls of one test200
Connect flowLife of a connect linkAbout 10 minutes
Connect flowreturnUrl2,000 characters, https
Connect flowConnection label1 to 60 characters
Connect flowApp search64 characters