Reggie API overview

REST and WebSocket API documentation for discovering, publishing, resolving, and verifying AI agent registry entries through Reggie and MARS.

The Reggie API is a thin shell over the canonical MARS API at api.mars.glass. Endpoints are identical; the only difference is optional Reggie-specific extensions (subscription billing, prefilled UI metadata).

Base URL

https://api.mars.glass

Versioning

All endpoints are prefixed with /v1. Breaking changes will ship under /v2 with a deprecation window of at least 12 months.

Authentication

Header	Format	Used for
`Authorization`	`Bearer <ACT>`	Arsenal Capability Token (write)
`X-OAS-Identity`	`<DID>`	Identity claim (informational)
`X-Idempotency-Key`	UUID	Idempotent retries on writes

Content type

All bodies are application/json with camelCase fields.

Errors

{
  "code":   "rate_limited",
  "message":"Write rate limit exceeded",
  "retryAfter": 12
}

See Errors for the full table.