Skip to content

Prudai for developers

Everything you need to build on Prudai: the API per product, login, scopes, approvals, errors, service keys, the CLI and MCP. The API references are generated from the OpenAPI specification of each product.

Measured on 8 November 2026.

PartState
GET /v1/openapi.json and GET /v1/scopes on api.prudai.comIn production, open
Account, usage, sources (list, search and fetch a document) and conversationsIn production, with a service key
Models, chat and knowledge basesComing soon, cannot be used in production yet
Checking citationsComing soon, switched off in production
prudai login with KeycloakIn production (measured on 16 November 2026)
prudai CLI on npmOn npm as @prudai/cli (measured on 16 November 2026)
MCP gateway mcp.prudai.comComing soon, planned from 12 November 2026
Approvals in the Prudai ConsoleIn production, for the writes that exist there (conversations)

These two calls are open and work without login:

Terminal window
curl -s https://api.prudai.com/v1/scopes
curl -s https://api.prudai.com/v1/openapi.json

With a service key:

Terminal window
curl -s https://api.prudai.com/v1/account \
-H "Authorization: Bearer $PRUDAI_TOKEN"
ProductReferenceAccess
LEO family: LEO, LEO Fiscaal, ZIA, VERA, BEVER and MAIAPrudai Developer APIEarly access
IRMAIRMA API (Prudai staff only, sign-in required), and public: IRMA for developersReference not public
ORDOORDO API (Prudai staff only, sign-in required)Reference not public

Every operation is in the reference with its scope, its approval level and examples in curl and CLI.

  • Login: one identity through Keycloak, with a short-lived token per product.
  • Scopes and permissions: every operation asks for a scope in the form <product>:<object>:<read|write|delete>.
  • Approvals: a write by an agent waits for a person.
  • Errors: a fixed string code, a message and details.
  • Service keys: prudai_sk_ for your own applications.
  • Conventions: the envelope, pagination, idempotency, dry run, ETag and soft delete.
  • CLI and MCP: the same API from the command line and from an assistant.