Mailboxes

Grant a member access to a mailbox

Shares a mailbox with an organization member and returns the grant with status 201. The member must already belong to the organization. A member who already holds a grant conflicts rather than being rewritten: change an existing grant with PATCH /v1/mailboxes/{id}/grants/{grantId}, so a grant is never widened as a side effect of granting. List the current grants with GET /v1/mailboxes/{id}/grants.

post/v1/mailboxes/{id}/grants

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/mailboxes/{id}/grants
  • Auth: API key in header x-api-key

Path parameters

idstring required

Request body

userIdstring required
role'admin' | 'collaborator' | 'viewer' required
sendMode'send' | 'approval'

How the grantee's sends execute: send runs them within account limits; approval holds each one until a different member approves it.

Response

Success

idstring required
permissionsstring[] required
sendMode'send' | 'approval' required

How the grantee's sends execute: send runs them within account limits; approval holds each one until a different member approves it.

createdAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.