# Ablo

> An open protocol for agent-native multiplayer state

## Docs

- [API](https://docs.abloatai.com/api.md)
- [API Keys](https://docs.abloatai.com/api-keys.md)
- [Inspect a capability](https://docs.abloatai.com/api-reference/capabilities/inspect-a-capability.md): Returns the metadata for a capability — does NOT return the token. Use to audit allowedSyncGroups/operations/expiry/revocation status.
- [Mint a capability token](https://docs.abloatai.com/api-reference/capabilities/mint-a-capability-token.md): Mints a Biscuit capability scoped to the requested sync-groups and operations. Returns the token only once — store it client-side. Mintable by human sessions and API-key principals; agents cannot self-mint.
- [Revoke a capability](https://docs.abloatai.com/api-reference/capabilities/revoke-a-capability.md): Marks the capability as revoked. Future verifications fail with `capability_invalid`. In-flight WS connections holding this cap are not actively disconnected — TTL is the dominant constraint.
- [Declare an intent](https://docs.abloatai.com/api-reference/intents/declare-an-intent.md): Broadcast a pre-write declaration that the caller intends to act on a target. Other participants see the intent and can defer or coordinate. Idempotent on `intentId`.
- [List active intents](https://docs.abloatai.com/api-reference/intents/list-active-intents.md): Returns currently-held intents in the caller's org. Filter via query params.
- [Release an intent](https://docs.abloatai.com/api-reference/intents/release-an-intent.md): Releases the intent immediately. Idempotent — releasing an already-released intent returns 200.
- [Fetch a single resource](https://docs.abloatai.com/api-reference/resources/fetch-a-single-resource.md): Read-side bootstrap path. Returns the canonical row plus its sync watermark. Returns 404 if the resource is outside the caller's authorised sync-groups.
- [Commit one or more mutations](https://docs.abloatai.com/api-reference/state/commit-one-or-more-mutations.md): Submit a batch of typed mutations against a sync-group. Atomic: if any operation is denied or fails, the entire commit is rejected. Successful commits broadcast a typed `SyncDelta` to every co-present peer.
- [Close an agent task](https://docs.abloatai.com/api-reference/tasks/close-an-agent-task.md): Records final cost metrics and marks the task closed. All metering for the task aggregates against the caller's org + API key.
- [Open an agent task](https://docs.abloatai.com/api-reference/tasks/open-an-agent-task.md): Opens an agent task envelope. All commits made under this task's `causedByTaskId` link back here for audit. Prompt is stored hashed (audit-stable) + plaintext under separate retention.
- [Get usage aggregates](https://docs.abloatai.com/api-reference/usage/get-usage-aggregates.md): Returns daily usage aggregates for the caller's org over the requested window. Group by `api_key_id`, `team_id`, `event_name`, or `line_item`.
- [Audit log](https://docs.abloatai.com/audit.md)
- [Capabilities](https://docs.abloatai.com/capabilities.md)
- [Changelog](https://docs.abloatai.com/changelog.md): Product updates and releases for Ablo
- [Client Behavior](https://docs.abloatai.com/client-behavior.md)
- [Connect Your Database](https://docs.abloatai.com/data-sources.md)
- [Agent + Human](https://docs.abloatai.com/examples/agent-human.md)
- [AI SDK Tool](https://docs.abloatai.com/examples/ai-sdk-tool.md)
- [Existing Python Backend](https://docs.abloatai.com/examples/existing-python-backend.md)
- [Next.js Example](https://docs.abloatai.com/examples/nextjs.md)
- [Server Agent](https://docs.abloatai.com/examples/server-agent.md)
- [Guarantees](https://docs.abloatai.com/guarantees.md)
- [Ablo Docs](https://docs.abloatai.com/index.md)
- [Integration Guide](https://docs.abloatai.com/integration-guide.md)
- [Interaction Model](https://docs.abloatai.com/interaction-model.md)
- [Model Context Protocol](https://docs.abloatai.com/mcp.md)
- [Claude Code](https://docs.abloatai.com/mcp/claude-code.md)
- [Cursor](https://docs.abloatai.com/mcp/cursor.md)
- [Windsurf](https://docs.abloatai.com/mcp/windsurf.md)
- [Quickstart](https://docs.abloatai.com/quickstart.md)
- [React](https://docs.abloatai.com/react.md)
- [Roadmap](https://docs.abloatai.com/roadmap.md)

## OpenAPI Specs

- [openapi](https://docs.abloatai.com/openapi.json)