# samva-dev Mailboxes API

**Canonical:** https://apis.io/apis/samva-dev/samva-dev-mailboxes-api/  
**Provider:** samva-dev — https://apis.io/providers/samva-dev/  
**Base URL:** https://api.samva.dev  
**Documentation:** https://samva.dev/docs/api-reference

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

Mailboxes: endpoints, threads, messages, drafts, and governed sends

## Operations (60 of 62)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/mailboxes` | List mailboxes |
| POST | `/v1/mailboxes` | Create a mailbox |
| GET | `/v1/mailboxes/{id}` | Get a mailbox |
| PATCH | `/v1/mailboxes/{id}` | Update a mailbox |
| DELETE | `/v1/mailboxes/{id}` | Delete a mailbox |
| POST | `/v1/mailboxes/{id}/endpoints` | Add an endpoint to a mailbox |
| PATCH | `/v1/mailboxes/{id}/endpoints/{endpointId}` | Update a mailbox endpoint |
| DELETE | `/v1/mailboxes/{id}/endpoints/{endpointId}` | Remove an endpoint from a mailbox |
| POST | `/v1/mailboxes/{id}/pause` | Pause a mailbox |
| POST | `/v1/mailboxes/{id}/resume` | Resume a mailbox |
| GET | `/v1/mailboxes/{id}/agent-activity` | Get mailbox activity |
| GET | `/v1/mailboxes/{id}/grants` | List mailbox grants |
| POST | `/v1/mailboxes/{id}/grants` | Grant a member access to a mailbox |
| PATCH | `/v1/mailboxes/{id}/grants/{grantId}` | Update a mailbox grant |
| DELETE | `/v1/mailboxes/{id}/grants/{grantId}` | Revoke a mailbox grant |
| GET | `/v1/mailboxes/{id}/policies` | List mailbox policies |
| POST | `/v1/mailboxes/{id}/policies` | Create a mailbox policy |
| GET | `/v1/mailboxes/{id}/policies/{policyId}` | Get a mailbox policy |
| PATCH | `/v1/mailboxes/{id}/policies/{policyId}` | Update a mailbox policy |
| DELETE | `/v1/mailboxes/{id}/policies/{policyId}` | Delete a mailbox policy |
| GET | `/v1/mailboxes/{id}/folders` | List mailbox folders |
| GET | `/v1/mailboxes/{id}/labels` | List mailbox labels |
| POST | `/v1/mailboxes/{id}/labels` | Create a mailbox label |
| PATCH | `/v1/mailboxes/{id}/labels/{labelId}` | Update a mailbox label |
| DELETE | `/v1/mailboxes/{id}/labels/{labelId}` | Delete a mailbox label |
| GET | `/v1/mailboxes/needs-you` | List mailbox decisions awaiting you |
| GET | `/v1/mailboxes/threads` | List threads across your mailboxes |
| GET | `/v1/mailboxes/{id}/threads` | List threads in a mailbox |
| GET | `/v1/mailboxes/{id}/threads/{threadId}` | Get a mailbox thread |
| PATCH | `/v1/mailboxes/{id}/threads/{threadId}` | Update a mailbox thread |
| POST | `/v1/mailboxes/{id}/threads/{threadId}/labels` | Add thread labels |
| DELETE | `/v1/mailboxes/{id}/threads/{threadId}/labels` | Remove thread labels |
| GET | `/v1/mailboxes/{id}/threads/{threadId}/messages` | List messages in a mailbox thread |
| GET | `/v1/mailboxes/{id}/threads/{threadId}/content` | Read a mailbox thread |
| GET | `/v1/mailboxes/{id}/threads/{threadId}/notes` | List notes in a mailbox thread |
| POST | `/v1/mailboxes/{id}/threads/{threadId}/notes` | Create a mailbox note |
| PATCH | `/v1/mailboxes/{id}/threads/{threadId}/notes/{noteId}` | Update a mailbox note |
| DELETE | `/v1/mailboxes/{id}/threads/{threadId}/notes/{noteId}` | Delete a mailbox note |
| POST | `/v1/mailboxes/{id}/messages` | Send a new message |
| GET | `/v1/mailboxes/{id}/messages/{messageId}` | Get a mailbox message |
| GET | `/v1/mailboxes/{id}/messages/{messageId}/raw` | Get a message's raw MIME |
| GET | `/v1/mailboxes/{id}/messages/{messageId}/attachments/{attachmentId}` | Get a message attachment |
| POST | `/v1/mailboxes/{id}/messages/{messageId}/attachments/{attachmentId}/copy` | Copy a message attachment |
| POST | `/v1/mailboxes/{id}/messages/{messageId}/reply` | Reply to a message |
| POST | `/v1/mailboxes/{id}/messages/{messageId}/reply-all` | Reply to all recipients of a message |
| POST | `/v1/mailboxes/{id}/messages/{messageId}/forward` | Forward a message |
| GET | `/v1/mailboxes/{id}/quarantine` | List quarantined messages |
| POST | `/v1/mailboxes/{id}/messages/{messageId}/release` | Release a quarantined message |
| POST | `/v1/mailboxes/{id}/messages/{messageId}/discard` | Discard a quarantined message |
| GET | `/v1/mailboxes/{id}/drafts` | List drafts |
| POST | `/v1/mailboxes/{id}/drafts` | Create a draft |
| GET | `/v1/mailboxes/{id}/drafts/{draftId}` | Get a draft |
| PATCH | `/v1/mailboxes/{id}/drafts/{draftId}` | Update a draft |
| DELETE | `/v1/mailboxes/{id}/drafts/{draftId}` | Delete a draft |
| POST | `/v1/mailboxes/{id}/drafts/{draftId}/send` | Send a draft |
| GET | `/v1/mailboxes/{id}/actions` | List mailbox actions |
| GET | `/v1/mailboxes/{id}/actions/{actionId}` | Get a mailbox action |
| POST | `/v1/mailboxes/{id}/actions/{actionId}/cancel` | Cancel a mailbox send |
| POST | `/v1/mailboxes/{id}/actions/{actionId}/retry` | Resume a mailbox send |
| POST | `/v1/mailboxes/{id}/actions/{actionId}/approve` | Approve a mailbox action |

…and 2 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/samva-dev/openapi/samva-dev-mailboxes-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-email-domain-verification-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-contact-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-template-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-conversation-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-mailbox-message-schema.json

## Other samva-dev APIs (12)

- [samva-dev Agents API](https://apis.io/apis/samva-dev/samva-dev-agents-api/)
- [samva-dev Analytics API](https://apis.io/apis/samva-dev/samva-dev-analytics-api/)
- [samva-dev API Keys API](https://apis.io/apis/samva-dev/samva-dev-api-keys-api/)
- [samva-dev Attachments API](https://apis.io/apis/samva-dev/samva-dev-attachments-api/)
- [samva-dev Brands API](https://apis.io/apis/samva-dev/samva-dev-brands-api/)
- [samva-dev Campaigns API](https://apis.io/apis/samva-dev/samva-dev-campaigns-api/)
- [samva-dev Contact events API](https://apis.io/apis/samva-dev/samva-dev-contact-events-api/)
- [samva-dev Contact Groups API](https://apis.io/apis/samva-dev/samva-dev-contact-groups-api/)
- [samva-dev Contacts API](https://apis.io/apis/samva-dev/samva-dev-contacts-api/)
- [samva-dev Conversations API](https://apis.io/apis/samva-dev/samva-dev-conversations-api/)
- [samva-dev Custom Fields API](https://apis.io/apis/samva-dev/samva-dev-custom-fields-api/)
- [samva-dev Email API](https://apis.io/apis/samva-dev/samva-dev-email-api/)

## Tags

Mailboxes

---

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