# bubblio-dev Approvals API

**Canonical:** https://apis.io/apis/bubblio-dev/bubblio-dev-approvals-api/  
**Provider:** bubblio-dev — https://apis.io/providers/bubblio-dev/  
**Base URL:** https://api.bubblio.dev  
**Documentation:** https://bubblio.dev/docs/api

bubblio-dev Approvals API is one of 6 APIs that [bubblio-dev](https://apis.io/providers/bubblio-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include approvals. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The phone-first consent pages' API (bubblio.dev/a/{id} and /approvals).

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/approvals/a/{approvalId}` | The approval page's facts |
| POST | `/approvals/a/{approvalId}/options` | Mint the WebAuthn ceremony options |
| POST | `/approvals/a/{approvalId}/approve` | Approve — the human's passkey signature over the exact terms |
| POST | `/approvals/a/{approvalId}/decline` | Decline (no ceremony needed — declining must always be easy) |
| POST | `/approvals/session/options` | Mint a passkey sign-in challenge for the management surface |
| POST | `/approvals/session` | Verify the sign-in assertion → consent token |
| GET | `/approvals/mine` | Everything this passkey decided — the out-of-band kill-switch surface |
| POST | `/approvals/mine/{approvalId}/revoke` | Revoke an approved connection |
| POST | `/approvals/mine/mandates/{mandateId}/revoke` | Revoke a standing mandate (#37's one-tap kill-switch) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/bubblio-dev/openapi/bubblio-dev-approvals-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/bubblio-dev/json-schema/bubblio-dev-json-rpc-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/bubblio-dev/json-schema/bubblio-dev-agent-key-info-schema.json
- **JSONSchema** — https://artifacts.apis.io/bubblio-dev/json-schema/bubblio-dev-payment-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/bubblio-dev/json-schema/bubblio-dev-json-rpc-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bubblio-dev/json-schema/bubblio-dev-quote-id-schema.json
- **JSONSchema** — https://artifacts.apis.io/bubblio-dev/json-schema/bubblio-dev-door-id-schema.json

## Other bubblio-dev APIs (5)

- [bubblio-dev Agent Keys API](https://apis.io/apis/bubblio-dev/bubblio-dev-agent-keys-api/)
- [bubblio-dev Discovery API](https://apis.io/apis/bubblio-dev/bubblio-dev-discovery-api/)
- [bubblio-dev MCP API](https://apis.io/apis/bubblio-dev/bubblio-dev-mcp-api/)
- [bubblio-dev Platform Push API](https://apis.io/apis/bubblio-dev/bubblio-dev-platform-push-api/)
- [bubblio-dev Platform Sync API](https://apis.io/apis/bubblio-dev/bubblio-dev-platform-sync-api/)

## Tags

approvals

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bubblio-dev/bubblio-dev-approvals-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bubblio-dev/.