Email

Create a mailbox on domani.run

Create a free email address on domani.run (e.g. hello@domani.run). No domain ownership required. Limited to 1 free @domani.run mailbox per user. Many common slugs are reserved.

post/api/email

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/email
  • Auth: HTTP bearer

Request body

slugstring required

Local part of the email address (e.g. 'hello' for hello@domani.run)

namestring

Display name (defaults to capitalized slug)

Response

Mailbox created

idstring required
addressstring required
namestring nullable required
slugstring required
domainstring required
kindstring required
workspace_idstring nullable required
access_role'viewer' | 'responder' | 'manager' required
effective_capabilitiesstring[] required

Concrete permissions already intersected with mailbox role, workspace entitlement, and token scopes. Clients should render from these values instead of inferring behavior from access_role.

collaboration_enabledboolean required
sharedboolean required

Whether at least one principal other than the caller can read this mailbox

message_countinteger required
webhook_urlstring nullable required
header_namesstring[] required

Configured webhook authentication header names; values are never returned

forward_tostring nullable required
signing_secretstring nullable
created_atstring date-time required
hintstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.