{"manifestVersion":"1","app":{"name":"mail","version":"0.8.8","status":"live"},"actions":[{"id":"system.mail.address-reservations.create.v1","title":"Hold an address on the user mail domain for an account being created without an email (human 2026-10-08). The local part is a base: the bare name is tried first, then random 2–4 digit suffixes when a mailbox, alias, system name or another reservation owns it, so a retry for the same key returns the same address. Answers invalid for a reserved, brand-like or malformed base; taken only when every candidate is exhausted.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"localPart":{"type":"string","minLength":1,"maxLength":64},"reservedFor":{"type":"string","minLength":1,"maxLength":200},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200}},"required":["localPart","reservedFor","idempotencyKey"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","enum":["reserved","taken","invalid"]},"address":{"type":["string","null"]}},"required":["kind","address"],"additionalProperties":false}},{"id":"system.mail.domain-records.get.v1","title":"The DNS records mail needs on one of an org’s domains — MX, SPF, DKIM and DMARC, with the DKIM key mail signs with — and whether each is published right now, checked live. Null when mail is not set up on that domain for that org. orgs shows them on its Domains page; mail stays the only owner of the DKIM key and of what counts as correct.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orgId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"domain":{"type":"string","minLength":1,"maxLength":253}},"required":["orgId","domain"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mail":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["pending","active","disabled"]},"records":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["mx","spf","dkim","dmarc"]},"type":{"type":"string","enum":["MX","TXT"]},"name":{"type":"string","maxLength":253},"value":{"type":"string","maxLength":4096},"ok":{"type":"boolean"}},"required":["kind","type","name","value","ok"],"additionalProperties":false}}},"required":["state","records"],"additionalProperties":false},{"type":"null"}]}},"required":["mail"],"additionalProperties":false}},{"id":"system.mail.system-addresses.create.v1","title":"Add a platform system mailbox name. A name routes on the user and platform domains only unless it is a built-in role, and it can never be issued to a person or an organisation.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"localPart":{"type":"string","minLength":2,"maxLength":40},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"routes":{"type":"boolean"},"audience":{"type":"string","enum":["platform","any_local"]},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200}},"required":["localPart","label","description","routes","audience","idempotencyKey"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","enum":["created","unchanged","exists","invalid","taken"]},"row":{"anyOf":[{"type":"object","properties":{"localPart":{"type":"string","minLength":1,"maxLength":40},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"routes":{"type":"boolean"},"enabled":{"type":"boolean"},"builtIn":{"type":"boolean"},"audience":{"type":"string","enum":["platform","any_local"]},"updatedAt":{"type":"string"}},"required":["localPart","label","description","routes","enabled","builtIn","audience","updatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["kind","row"],"additionalProperties":false}},{"id":"system.mail.system-addresses.list.v1","title":"Every platform system mailbox name, built-in and custom, with whether it routes and which local domains it accepts. Accounts shows it to a superadmin; mail owns the registry.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cursor":{"type":"string","minLength":1,"maxLength":512},"pageSize":{"type":"integer","minimum":1,"maximum":200}},"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"names":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"localPart":{"type":"string","minLength":1,"maxLength":40},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"routes":{"type":"boolean"},"enabled":{"type":"boolean"},"builtIn":{"type":"boolean"},"audience":{"type":"string","enum":["platform","any_local"]},"updatedAt":{"type":"string"}},"required":["localPart","label","description","routes","enabled","builtIn","audience","updatedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["names","nextCursor"],"additionalProperties":false}},{"id":"system.mail.system-addresses.update.v1","title":"Edit a system mailbox name’s label, description or enabled state. The local part and routing audience are immutable; a built-in name cannot be disabled.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"localPart":{"type":"string","minLength":2,"maxLength":40},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"enabled":{"type":"boolean"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200}},"required":["localPart","idempotencyKey"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","enum":["updated","unchanged","not_found","protected"]},"row":{"anyOf":[{"type":"object","properties":{"localPart":{"type":"string","minLength":1,"maxLength":40},"label":{"type":"string","minLength":1,"maxLength":120},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"routes":{"type":"boolean"},"enabled":{"type":"boolean"},"builtIn":{"type":"boolean"},"audience":{"type":"string","enum":["platform","any_local"]},"updatedAt":{"type":"string"}},"required":["localPart","label","description","routes","enabled","builtIn","audience","updatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["kind","row"],"additionalProperties":false}},{"id":"system.mail.wellknown.capabilities.v1","title":"The mail capabilities manifest: metadata, callable actions with schemas, public routes, emitted events, and model field catalogs. Public metadata only — a manifest never carries tenant rows.","route":"/.well-known/capabilities","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"manifestVersion":{"type":"string","const":"1"},"app":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"},"version":{"type":"string","minLength":1},"status":{"type":"string","enum":["live","degraded"]}},"required":["name","version","status"],"additionalProperties":false},"actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^system\\.[a-z0-9]+(-[a-z0-9]+)*\\.[a-z0-9]+(-[a-z0-9]+)*\\.[a-z0-9]+(-[a-z0-9]+)*\\.v[1-9][0-9]*$"},"title":{"type":"string","minLength":1},"route":{"type":"string","pattern":"^\\/"},"inputSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"outputSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","title","inputSchema","outputSchema"],"additionalProperties":false}},"functionalities":{"type":"object","properties":{"publicRoutes":{"type":"array","items":{"type":"string","pattern":"^\\/"}},"auth":{"type":"object","properties":{"issuer":{"type":"string","format":"uri"},"authorizationEndpoint":{"type":"string","format":"uri"},"tokenEndpoint":{"type":"string","format":"uri"},"jwksUri":{"type":"string","format":"uri"}},"required":["issuer"],"additionalProperties":false},"webhooks":{"type":"array","items":{"type":"string","minLength":1}}},"required":["publicRoutes","webhooks"],"additionalProperties":false},"events":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z0-9][a-z0-9.-]*[a-z0-9]$"},"title":{"type":"string","minLength":1},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["name","title","schema"],"additionalProperties":false}},"models":{"type":"object","propertyNames":{"type":"string","minLength":1},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","minLength":1},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"excluded":{"type":"array","items":{"type":"string","minLength":1}}},"required":["title","schema","excluded"],"additionalProperties":false}}},"required":["manifestVersion","app","actions","functionalities","events"],"additionalProperties":false}}],"functionalities":{"publicRoutes":[],"webhooks":[]},"events":[{"name":"mail.message.sent","title":"mail: message sent","schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ownerType":{"type":"string","enum":["org","user"]},"ownerId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"messageId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"threadId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mailboxId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"to":{"minItems":1,"type":"array","items":{"type":"string"}},"subject":{"type":"string"},"queueId":{"type":["string","null"]},"sentAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["ownerType","ownerId","messageId","threadId","mailboxId","to","subject","queueId","sentAt"],"additionalProperties":false}},{"name":"mail.message.received","title":"mail: message received","schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ownerType":{"type":"string","enum":["org","user"]},"ownerId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"messageId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"threadId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mailboxId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"from":{"type":"string"},"subject":{"type":"string"},"receivedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["ownerType","ownerId","messageId","threadId","mailboxId","from","subject","receivedAt"],"additionalProperties":false}}],"models":{}}