Skip to main content

Documentation Index

Fetch the complete documentation index at: https://sovrnti.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The pages below are generated from the OpenAPI 3.1 spec the TypeScript SDK is built from. There is one source of truth behind both this reference and the SDK.

​
Authentication

All endpoints require a Bearer JWT issued by auth.sovrnti.io. The same token works for both REST (/v1/*) and MCP (/mcp) — aud=https://graph.sovrnti.io/mcp (RFC 8707). If you don’t have a token yet, follow the REST Quickstart for the OAuth 2.1 + PKCE flow.

​
Errors

Every error response uses RFC 9457 Problem Details (Content-Type: application/problem+json). Every Problem includes:
  • type — stable URL-resolvable identifier
  • title — short human description
  • status — HTTP status code
  • detail — full description (when applicable)
  • next_actions — agent-actionable recovery hints
Example: 
{
	"type": "https://docs.sovrnti.io/errors/insufficient-scope",
	"title": "Insufficient scope: Ping.Read required",
	"status": 403,
	"detail": "The presented JWT does not include the required scope 'Ping.Read'.",
	"instance": "8c3f0a4b-…",
	"next_actions": ["Request a token with scope 'Ping.Read' via the OAuth flow."]
}

​
Headers on every response

  • Data-Residency-Zone — eu-west-fr for the EU region.
  • X-Request-Id — UUID for log correlation. Include this when reporting issues.