APIRate limits
List rate limit rules
List rate limit rules. Optionally filtered by status.
GET
List rate limit rules. Optionally filtered by status.
ApiKeyAuthheader
AuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_rate_limitsstatus?stringWhether a rate limit rule is in effect.
Value in
"active""disabled"The request has succeeded.
application/json- response
items*array<>curl -X GET "https://example.com/rate-limits/rules"{ "items": [ { "id": null, "name": "string", "description": "string", "status": "active", "scope": { "type": "mcp_tool_call", "mcp_ids": [ "c2c9208c-a7ac-41cc-84f1-8c1caec92987" ], "agent_slugs": [ "string" ], "agent_instance_ids": [ "bc3f18ff-0dcd-4cc7-8f61-6ca61814f10b" ], "user_ids": [ "2d98503d-4ab4-41bd-8fc6-78cc006fd2db" ], "groups": [ "string" ], "agent_slug_tag_ids": [ "e428595a-d9dd-4887-8327-2d9cad5b7425" ], "mcp_tag_ids": [ "17d4a46c-d971-4171-9a66-88ec59ce6eeb" ], "tool_tag_ids": [ "41068329-9b4f-4cc3-b249-3ec2a7a2cee8" ], "tool_patterns": [ "string" ], "condition": "string", "condition_description": "string" }, "key_by": [ "org" ], "limit": 1, "window_seconds": 1, "burst": 0, "action": "deny", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ]}End seat price POST
End a plan price; only valid while the row is still open. For a live row this closes it effective now. For a not-yet-started (scheduled) row it cancels the schedule and re-extends the price it superseded, so the prior rate resumes for the months the scheduled row would have covered.
Create rate limit rule POST
Create a rate limit rule.