Bellaso Agent API | Bellaso API

REST twin of the Bellaso MCP tool registry. Every tool exposed over MCP is also callable here: POST /api/v1/tools/{name} with the tool's arguments as the JSON body.

Authentication: Authorization: Bearer ck_... — an organization-scoped endpoint token minted in the Bellaso console. The token pins the organization; there is no organization parameter on any operation, and any organization id sent in a body is ignored. Calls are rate limited per endpoint (per minute and per day) and every call is audited.

SCHEMA CAVEAT: argument schemas are generated from the server's own validation schemas, so they are exact about property names, types and unknown-key rejection. They cannot express CROSS-FIELD constraints (for example "start_date must be on or before end_date"), which are still enforced server-side and answered with a 400 validation_error. Treat the published schema as necessary, not sufficient.