# Sentvia

## Docs

- [GET /attachments/{id} — Get a Signed Attachment Download URL](https://docs.sentvia.ai/api-reference/attachments/get-id.md): Retrieve a fresh signed download URL for a stored attachment. Short-lived and grants direct access to the file bytes with no extra authentication required.
- [DELETE /inboxes/{id} — Permanently Delete an Inbox](https://docs.sentvia.ai/api-reference/inboxes/delete-id.md): Permanently delete an inbox by ID. All associated messages and threads are removed. Returns 204 on success, 404 if the inbox does not exist.
- [GET /inboxes — List All Email Inboxes in Your Workspace](https://docs.sentvia.ai/api-reference/inboxes/get.md): Return all inboxes in your workspace as a JSON array. Each inbox object includes its ID, email address, display name, and creation timestamp.
- [POST /inboxes — Create and Provision a New Inbox](https://docs.sentvia.ai/api-reference/inboxes/post.md): Create a new inbox and get an email address ready to send and receive immediately. Accepts local_part and optional display_name and domain_id.
- [Sentvia REST API Reference — Overview and Conventions](https://docs.sentvia.ai/api-reference/introduction.md): The Sentvia API is a RESTful JSON API. Learn the base URL, authentication method, conventions for IDs and timestamps, and how errors are structured.
- [DELETE /labels/{id} — Delete a Label from Your Workspace](https://docs.sentvia.ai/api-reference/labels/delete-id.md): Delete a label by ID. Sentvia automatically removes it from all assigned messages. Returns 204 No Content on success. This action cannot be undone.
- [GET /labels — List All Labels in Your Sentvia Workspace](https://docs.sentvia.ai/api-reference/labels/get.md): Return all labels in your workspace. Each label includes its ID, name, color, and creation timestamp. Use IDs to assign, unassign, or delete labels.
- [POST /labels — Create a Label to Organize Your Messages](https://docs.sentvia.ai/api-reference/labels/post.md): Create a label to tag and organize messages. Provide a unique name and an optional hex color. Assign labels to messages with POST /labels/{id}/assign.
- [POST /labels/{id}/assign — Assign a Label to a Message](https://docs.sentvia.ai/api-reference/labels/post-id-assign.md): Attach a label to a message. Provide the label ID in the path and target message ID in the body. Returns the updated message with its full labels array.
- [POST /labels/{id}/unassign — Remove a Label from a Message](https://docs.sentvia.ai/api-reference/labels/post-id-unassign.md): Remove a previously assigned label from a message. Provide the label ID in the path and target message ID in the body. Returns the updated message object.
- [DELETE /lists/{id} — Remove an Allow or Block Rule by ID](https://docs.sentvia.ai/api-reference/lists/delete-id.md): Delete an allow or block rule by ID. The rule stops applying to inbound and outbound messages immediately. Returns 204 No Content on success.
- [GET /lists — List All Allow and Block Rules in Sentvia](https://docs.sentvia.ai/api-reference/lists/get.md): Return all allow and block rules in your workspace. Sentvia applies every rule automatically to inbound and outbound messages. Use IDs to remove rules.
- [POST /lists — Add an Allow or Block Rule to Your Workspace](https://docs.sentvia.ai/api-reference/lists/post.md): Create an allow or block rule for an email address or domain. All three fields — kind, direction, and pattern — are required. Rules apply immediately.
- [GET /messages — List and Search Messages by Inbox](https://docs.sentvia.ai/api-reference/messages/get.md): List or search messages across your workspace. Supports keyword, semantic, and hybrid search modes. Filter by inbox_id and paginate with limit.
- [GET /messages/{id} — Retrieve a Single Message by ID](https://docs.sentvia.ai/api-reference/messages/get-id.md): Fetch a single message by ID. The response includes body text, HTML, current delivery status, labels, and signed attachment download URLs.
- [POST /messages — Send an Outbound Email from an Inbox](https://docs.sentvia.ai/api-reference/messages/post.md): Send an email from an inbox. Provide recipients, subject, and body. Supports HTML and plain text, attachments, and idempotent sends via client_id.
- [POST /messages/{id}/forward — Forward an Email Message](https://docs.sentvia.ai/api-reference/messages/post-id-forward.md): Forward an existing message to new recipients. Sentvia sets the correct threading headers and prepends Fwd: to the subject automatically.
- [POST /messages/{id}/reply — Reply to an Email Message](https://docs.sentvia.ai/api-reference/messages/post-id-reply.md): Reply to an existing message. Sentvia automatically sets threading headers, derives recipients, and prefixes the subject with Re:.
- [GET /threads — List Inbox Email Conversation Threads](https://docs.sentvia.ai/api-reference/threads/get.md): List threads in an inbox, ordered by most recent activity. Each thread includes its subject, message count, and the timestamp of the last message.
- [GET /threads/{id} — Retrieve a Full Conversation Thread](https://docs.sentvia.ai/api-reference/threads/get-id.md): Retrieve a complete email thread including all messages in chronological order, with bodies, delivery statuses, and attachment metadata.
- [DELETE /webhooks/{id} — Remove a Webhook Endpoint by ID](https://docs.sentvia.ai/api-reference/webhooks/delete-id.md): Delete a webhook endpoint by ID. No further events are delivered to that URL. Returns 204 No Content on success and 404 if the ID is unknown.
- [GET /webhooks — List All Registered Webhooks in Sentvia](https://docs.sentvia.ai/api-reference/webhooks/get.md): Return all webhook endpoints in your workspace, including their URLs, subscribed events, and creation timestamps. Signing secrets are never returned here.
- [POST /webhooks — Register a New Webhook Endpoint in Sentvia](https://docs.sentvia.ai/api-reference/webhooks/post.md): Register a URL to receive real-time email event notifications. Provide a url and events array. Returns a signing secret shown once — store it immediately.
- [Sentvia API Authentication: Keys and Base URL Guide](https://docs.sentvia.ai/authentication.md): Sentvia uses Bearer API keys for all requests. Learn how to create, rotate, and securely store your API keys and handle authentication errors.
- [Sentvia Inboxes: Email Addresses for Your AI Agents](https://docs.sentvia.ai/concepts/inboxes.md): An inbox is an email address your agent owns. Learn how to create, list, and delete inboxes, and understand plan limits and custom domains.
- [Receiving Inbound Email and Delivery Events in Sentvia](https://docs.sentvia.ai/concepts/receiving.md): Inbound mail is parsed, threaded, and pushed to your webhook. Verify HMAC-SHA256 signatures and handle delivery, bounce, and complaint events in real time.
- [Sending Email from AI Agents: Sentvia Concepts Guide](https://docs.sentvia.ai/concepts/sending.md): Send, reply to, and forward messages from any inbox. Includes idempotency, attachment support, and automatic suppression of bounced and blocked recipients.
- [Sentvia Threads: Follow Email Conversations Across Messages](https://docs.sentvia.ai/concepts/threads.md): Sentvia threads conversations using RFC-5322 headers. List threads, read full message history, and keep replies correctly threaded in any mail client.
- [Control Email Traffic with Allow and Block List Rules](https://docs.sentvia.ai/guides/allow-block-lists.md): Create allow and block rules for addresses or domains to filter outbound sends and inbound mail, on top of automatic bounce and complaint suppression.
- [Send and Receive Email File Attachments in Sentvia](https://docs.sentvia.ai/guides/attachments.md): Attach files to outbound messages with base64 encoding. Inbound attachments are stored automatically with signed download URLs and per-plan storage limits.
- [Send Email from Your Own Custom Domain with Sentvia](https://docs.sentvia.ai/guides/custom-domains.md): Add a verified custom domain to send email from your own brand. Sentvia manages SPF, DKIM, and DMARC automatically. Available on Pro plans and above.
- [Handle Sentvia API Errors and Status Codes Gracefully](https://docs.sentvia.ai/guides/errors.md): Sentvia returns standard HTTP status codes with structured JSON error bodies. Learn the error schema, plan-limit errors, and best practices for retries.
- [Give AI Agents Native Email Tools via the Sentvia MCP](https://docs.sentvia.ai/guides/mcp.md): Connect Sentvia's MCP server to give AI agents native email tools — create inboxes, send, reply, and search without writing any API calls.
- [Search Messages by Keyword, Meaning, or Both in Sentvia](https://docs.sentvia.ai/guides/search.md): Search every inbox with keyword, semantic, or hybrid mode. Semantic and hybrid search require a Pro plan or above and fall back gracefully on lower plans.
- [Sentvia: Managed Email Infrastructure for AI Agents](https://docs.sentvia.ai/introduction.md): Sentvia is a managed email API for AI agents. Provision inboxes, send and receive mail, thread conversations, and react to events in real time.
- [Sentvia Quickstart: Send Your First Email in 5 Minutes](https://docs.sentvia.ai/quickstart.md): Create an inbox, send your first email, and receive a reply with webhooks — complete your first Sentvia integration in under five minutes.