# Inbin API

**Canonical:** https://apis.io/apis/inbin-dev/inbin-dev-api/  
**Provider:** Inbin — https://apis.io/providers/inbin-dev/  
**Base URL:** https://api.inbin.dev/v1  
**Documentation:** https://inbin.dev/docs

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

Inbin API as documented publicly: 59 operations. Contract generated from the documentation by API Evangelist (2026-11-12); not the provider's own document.

## Operations (59)

| Method | Path | Summary |
|---|---|---|
| POST | `/agent-actions/confirm` | An agent action that requires owner confirmation. |
| POST | `/agent-identity/issuers` | Add an OpenID Connect issuer for agent identities. |
| POST | `/agent-identity/present` | Present a token for agent identity verification. |
| POST | `/agent-identity/start` | Start sign‑in flow for an agent identity. |
| POST | `/api/mcp` | POST /api/mcp |
| POST | `/api/v1/sends/approve` | POST /api/v1/sends/approve |
| GET | `/apps` | The caller’s application: name, webhook URL, plan, usage this month. |
| PATCH | `/apps` | PATCH accepts name and webhook_url , so CI can point Inbin at a fresh endpoint in the same pipeline that deploys it. |
| GET | `/assertions/claims` | List operative claims for a predicate |
| POST | `/backfill` | POST /backfill |
| GET | `/confirmations/await` | GET /confirmations/await?wait&since&inbox_id&expected_sender |
| GET | `/decisions` | List decisions |
| POST | `/decisions` | Record a decision event |
| GET | `/events` | Events GET /events?inbox_id&query&mode&status&type&confirmation&since&min_class |
| GET | `/events/{id}` | GET /events/:id |
| GET | `/events/{id}/raw` | Get raw email for an event |
| POST | `/events/{id}/re-extract` | Re‑runs extraction from the stored raw email |
| POST | `/events/{id}/redeliver` | Replays the webhook for an event |
| POST | `/events/{id}/release` | Release an event (owner plane) |
| POST | `/events/{id}/release-request` | Request release of an event |
| DELETE | `/events/{id}/shares` | Delete a share |
| POST | `/events/{id}/shares` | Share an event with another inbox |
| GET | `/health` | /health is unauthenticated and checks the database: 200 healthy, 503 not. |
| GET | `/inboxes` | Inboxes |
| POST | `/inboxes` | Creating an inbox returns its address immediately. |
| DELETE | `/inboxes/{id}` | Deleting an inbox orphans its mail flow. |
| GET | `/inboxes/{id}` | Inboxes |
| PATCH | `/inboxes/{id}` | PATCH accepts name and agent_access ( "full" \| "restricted" , see Restricted inboxes ). |
| POST | `/ingest/raw` | POST /ingest/raw?inbox=<slug> |
| GET | `/meetings` | List meetings |
| POST | `/meetings/{id}/leave` | Leave a meeting |
| GET | `/meetings/{id}/report` | Get meeting report |
| GET | `/meetings/{id}/transcript` | Get meeting transcript |
| POST | `/meetings/pause` | Pause meetings for an inbox |
| GET | `/meetings/search` | Search meetings |
| GET | `/memory/connections` | List memory connections |
| POST | `/memory/connections` | Connect a memory provider |
| DELETE | `/memory/connections/{id}` | Disconnect a memory connection |
| GET | `/policy` | Your policy is a list of rows, each a capability. |
| POST | `/policy` | An owner setting: an agent connection that adds or removes a contact asks the owner first. |
| POST | `/policy/inbound` | grant_inbound_standing, revoke_inbound_standing, an owner setting for inbound standing. |
| POST | `/policy/revoke` | Revoke a capability row from the policy. |
| GET | `/policy/wake` | Get the current wake policy. |
| PUT | `/policy/wake` | set_wake_policy, an owner setting: who may wake the agent through email.received. |
| POST | `/query` | POST /query |
| GET | `/resolve/{id}` | Resolve an event id to a verified structured event |
| PUT | `/schemas` | A PUT replaces the schema and bumps the version. |
| GET | `/schemas/current` | GET /schemas/current |
| GET | `/sends` | GET /sends?status= |
| POST | `/sends` | POST /sends |
| POST | `/sends/approval-request` | POST /sends/approval-request |
| POST | `/sends/approve` | POST /sends/approve |
| POST | `/v1/inboxes` | POST /v1/inboxes |
| POST | `/v1/policy` | Set policy rows |
| POST | `/v1/policy/revoke` | Revoke a policy row |
| GET | `/views` | List views |
| POST | `/views` | Create a standing view (saved query grant) |
| DELETE | `/views/{id}` | DELETE /views/:id |
| GET | `/views/{id}/resolve` | GET /views/:id/resolve |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/inbin-dev/openapi/_ae-authored/inbin-dev-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/inbin-dev/json-schema/inbin-dev-post-events-id-shares-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/inbin-dev/json-schema/inbin-dev-post-sends-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/inbin-dev/json-schema/inbin-dev-post-sends-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/inbin-dev/json-schema/inbin-dev-post-backfill-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/inbin-dev/json-schema/inbin-dev-get-confirmations-await-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/inbin-dev/json-schema/inbin-dev-post-inboxes-response-schema.json

## Other Inbin APIs (1)

- [Inbin API](https://apis.io/apis/inbin-dev/inbin-api/)

---

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