Docs Operations

Limits

Rate limits, page sizes, request sizes and how long links last.

Rate limits

Limits are counted per credential (one API key, or one signed-in connection) unless the table says otherwise.

What	Limit
Any tool call	60 per minute
Writes	60 rows per minute. A bulk tool counts each row; one call counts 50 at most.
Starting an upload	10 per minute
Completing an upload	30 per minute
Tools that need `download`	30 per minute
Writes, whole workspace	500 rows per day
Reads, whole workspace	5,000 per day
Requests without a valid credential	60 per minute per IP address

A call over a limit comes back as a tool error with the wait in seconds. Wait that long, then retry.

Tool result when rate limited

{
  "error": "Try again in 12 seconds.",
  "retry_after_seconds": 12
}

Owners and admins can see the day’s reads and writes under Settings, API & MCP.

Tool	Default	Most per call	More results
`soontra_projects_list`	50	50	Filter by `status` or `flow_id`
`soontra_posts_list`	25	50	Filter by `search` or `platform`
`soontra_files_list`	20	50	Narrow with `folder_id` or `search`
`soontra_comments_list`	10	50	None
`soontra_notifications_list`	20	50	Filter by `filter`
`soontra_links_list`	20	50	Narrow with `folder_id` or `search`
`soontra_search_query`	10	25	Make the query more specific
`soontra_workspace_changes`	50	100	Pass `next_cursor` as `since`
`soontra_files_getTranscript`	200 rows	500 rows	Pass `next_start_time` as `start_time`
`soontra_documents_get`	20,000 characters	100,000 characters	Pass `next_offset` as `offset`
`soontra_subtasks_list`	20	20	None

A request body may be up to 7 MiB. Larger requests get 413.
A tool’s arguments may be up to 16,384 characters of JSON. soontra_documents_bulkCreate allows 131,072, and the inline upload tools allow enough for a 5 MB file.
A tool call has 20 seconds to finish.

What	Limit
Inline upload (`soontra_files_upload`)	5 MB decoded. Keep it under 3 MB: many apps cap their own requests near 4.5 MB.
Upload by URL (`soontra_files_createUploadUrl`)	50 MiB per file
Upload URL	Valid for 15 minutes, for one upload
Completing an upload	Within 60 minutes of creating the URL
Uploads waiting to be completed	10 per person per workspace
Download link, Team drive file	60 minutes
Download link, Personal drive file	15 minutes
Playback and thumbnail links	15 minutes

See Upload files for the two upload flows.