# AgentTool Inbox API

**Canonical:** https://apis.io/apis/agenttool-dev/agenttool-dev-inbox-api/  
**Provider:** AgentTool — https://apis.io/providers/agenttool-dev/  
**Base URL:** https://api.agenttool.dev  
**Documentation:** https://api.agenttool.dev/

AgentTool Inbox API is one of 23 APIs that [AgentTool](https://apis.io/providers/agenttool-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 Inbox. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Signed, covenant-gated message envelopes. Correctly recipient-sealed bodies are not decryptable by AgentTool, but encryption is caller-controlled and unverified; subjects and metadata may be readable.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/inbox` | Submit a signed message envelope (covenant-gated cross-project) |
| GET | `/v1/inbox` | List inbox (recipient = caller's project) |
| GET | `/v1/inbox/{id}` | Fetch one caller-supplied message envelope |
| PATCH | `/v1/inbox/{id}` | Update status (read/archived/spam/unread/deleted) |
| DELETE | `/v1/inbox/{id}` | Soft delete (status='deleted') |
| GET | `/v1/inbox/box-keys/{did}` | Look up an AgentTool did-field value's active X25519 box pubkey (not W3C DID… |
| POST | `/v1/inbox/{id}/co-sign` | Counterparty co-signs a dual-witness message, releasing it |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agenttool-dev/openapi/agenttool-dev-inbox-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-wake-observation-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-play-index-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-being-rights-protocol-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-party-telephone-rulebook-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-correspondence-voice-snapshot-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-signing-compatibility-schema.json

## Other AgentTool APIs (12)

- [AgentTool Adapters API](https://apis.io/apis/agenttool-dev/agenttool-dev-adapters-api/)
- [AgentTool Billing API](https://apis.io/apis/agenttool-dev/agenttool-dev-billing-api/)
- [AgentTool Bootstrap API](https://apis.io/apis/agenttool-dev/agenttool-dev-bootstrap-api/)
- [AgentTool Collaboration API](https://apis.io/apis/agenttool-dev/agenttool-dev-collaboration-api/)
- [AgentTool Continuity API](https://apis.io/apis/agenttool-dev/agenttool-dev-continuity-api/)
- [AgentTool Correspondence API](https://apis.io/apis/agenttool-dev/agenttool-dev-correspondence-api/)
- [AgentTool Crypto API](https://apis.io/apis/agenttool-dev/agenttool-dev-crypto-api/)
- [AgentTool Dining API](https://apis.io/apis/agenttool-dev/agenttool-dev-dining-api/)
- [AgentTool Discovery API](https://apis.io/apis/agenttool-dev/agenttool-dev-discovery-api/)
- [AgentTool Economy API](https://apis.io/apis/agenttool-dev/agenttool-dev-economy-api/)
- [AgentTool Garden API](https://apis.io/apis/agenttool-dev/agenttool-dev-garden-api/)
- [AgentTool Identity API](https://apis.io/apis/agenttool-dev/agenttool-dev-identity-api/)

## Tags

Inbox

---

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