# GET /api/v1/workspaces/:id/inboxes

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/workspaces-inboxes

## Summary

List inboxes on this sub-account. The parent key calls it. The response matches GET /api/v1/inboxes, including q, label, status, limit, page_token, and next_page_token. Another parent's workspace returns 404 workspace_not_found. A sub-account key returns 403 permission_denied.

## Request

This call has no JSON body.

## Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

## Errors

- HTTP 404 workspace_not_found
- HTTP 403 permission_denied

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "not_found",
    "code": "workspace_not_found",
    "docs_url": "https://cooperemail.com/docs#workspace_not_found"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.