Skip to content
โ—‡ AirawatOS Developer
๐Ÿšง Under development โ€” this portal is being built track by track. Content will keep growing, and some sections are still placeholders.

Reference

โ† Schema catalogue

platform.inbox_item

domain: platform

A single item in the UNIFIED INBOX โ€” every task, notification, and decision an actor needs to see, from any solution, in one place. The inbox is registry-backed; both case tasks and notifications write these.

FieldTypeRequiredDescription
schemaโ€”โœ“
idstringโœ“
actorstringโœ“who this is for โ€” user://<tenant>/<sub> or role://<tenant>/<role>
kindstringโœ“
titlestringโœ“
bodystring
refstringRESOLVABLE reference to the subject this item is about โ€” ds:<steward>:<local> (local or cross-tenant, resolved at source) or <scheme>://<steward>/<id> (a resolvable entity via an agency connector,). The inbox resolves this to render the subject.
handlerstringhow to render/act on this item โ€” a governed interaction/task declaration id, or app://<steward>/<app>/<route>. The inbox is generic and dispatches to the handler; absent = render the resolved subject + declared actions.
actionsarray<string>allowed actions for this item (e.g. approve, reject, decide, contest). Each action produces a decided change-request โ†’ decision โ†’ receipt.
sourcestringthe solution/component that raised it
statusstring
tenantstring
created_atstringโœ“