Delete an inbox by ID or address
Deletes an inbox identified by either its id (a UUID) or its full address — any {inbox} value containing @ is resolved as an address, otherwise as an id.
Deletes an inbox identified by either its id (a UUID) or its full address — any {inbox} value containing @ is resolved as an address, otherwise as an id. Returns 204 No Content with an empty body. Deleting an inbox also deletes its threads and messages. The delete is scoped to your account: an inbox that is already gone, was never on your account, or is outside the inboxes of a key restricted to specific inboxes returns 404, so nothing is deleted silently. Requires the inboxes:write scope and is rate-limited to 50 delete calls per hour.
Scope: inboxes:write. Send the API key as a bearer token; Scopes lists what each one reaches.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
inbox | string | yes | The inbox: its UUID or its full address (e.g. agent@dairo.app). |
Response
200 Success. Body: application/json, DeleteResponse.
| Field | Type | Required | Description |
|---|---|---|---|
deleted | boolean | yes |
Errors
Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.
| Status | Meaning |
|---|---|
400 | The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch). |
401 | The API key is missing or invalid. |
403 | The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted). |
404 | No such resource in this account (resource_not_found). |
422 | The request is well-formed but a field failed validation (validation_failed). |
429 | Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached). |
500 | An unexpected error; retry with backoff, then contact support (internal_error). |
Update an inbox's agent or routing mode
Updates an inbox's assigned agent and/or routing mode in place, resolving the target by id (UUID) or full address.
Get an inbox's extraction contract
Returns the extraction contract attached to the inbox, including its schema map, the onValidationError policy (quarantine or passthrough), any extractionHint, and createdAt/updatedAt timestamps.