List who has access to this mailbox
Returns everyone this mailbox has been shared with, oldest grant first, each with the rights they hold. This is the owner's side of sharing; to list mailboxes shared WITH you, use GET /shared-mailboxes instead.
The full list is always returned — grants are bounded by the account's own membership, so there is no paging.
bearerAuthAuthorizationBearer <token>Two credential kinds share this scheme; GET /api/v1/auth/whoami answers which one you hold and what it reaches.
oek_… API key (minted by POST /api/v1/api-keys; shown once at mint). role: account reaches the full account surface: the directory (domains, routes, patterns, api-keys, accounts, address lists) plus every mailbox the account owns. role: system additionally reaches the operator surface, which is documented separately.
oemp_… mailbox app password (minted by POST /api/v1/identities/{identityId}/credentials). Reaches ONE mailbox: its messages, labels, threads, search, sync, send, filters and PIM collections. Directory routes refuse it with 403 insufficient_scope.
Refusal vocabulary: a missing, malformed, expired, or revoked credential answers 401 unauthorized with a WWW-Authenticate: Bearer challenge; a VALID credential outside its scope answers 403 (insufficient_scope for an app password on a directory route, system_credentials_required where only the operator may call). The public routes (health, branding, token-in-path capabilities) declare security: [].
mailboxId*stringULID of the mailbox whose access is being managed
Everyone with access to this mailbox, oldest grant first
application/json- response
shares*array<>curl -X GET 'https://api.open.email/api/v1/mailboxes/string/shares'{
"shares": [
{
"createdAt": 0,
"granteeAddress": "string",
"granteeIdentityId": "string",
"labelScope": [
"string"
],
"mailboxId": "string",
"rights": "string"
}
]
}Remove another user's access to this mailbox DELETE
Takes away an identity's access to this mailbox. Access stops immediately — rights are re-read on every request, so a session that is already open loses the…
List mailboxes shared with you GET
Returns every mailbox belonging to someone else that you have been given access to, oldest grant first, each with the rights you hold on it. Use the returned…