MARS API overview

REST and WebSocket API documentation for AI agent registry entries, discovery, MARS-QL, lineage, attestations, federation, and live events.

https://api.mars.glass
Group Endpoints
Entries POST /v1/entries, GET /v1/entries/:did, PUT /v1/entries/:did, DELETE /v1/entries/:did, GET /v1/entries/:did/versions
Discover POST /v1/discover, POST /v1/discover/marsql
Lineage GET /v1/lineage/:did
Attestations POST /v1/attestations, GET /v1/attestations/:did
Federation GET /v1/registries, POST /v1/federate/handshake, POST /v1/federate/sync
Events WS /v1/events
Health GET /v1/health

Versioning

/v1 is stable. Breaking changes ship under /v2 with ≥12mo deprecation.

Authentication

Bearer Arsenal Capability Tokens (ACTs) on writes. Reads are public, rate-limited per IP.

Errors

{ "code": "rate_limited", "message": "...", "retryAfter": 12 }

See Errors for the full table.