Reference
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.
| Field | Type | Required | Description |
|---|---|---|---|
schema | โ | โ | |
id | string | โ | |
actor | string | โ | who this is for โ user://<tenant>/<sub> or role://<tenant>/<role> |
kind | string | โ | |
title | string | โ | |
body | string | ||
ref | string | RESOLVABLE 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. | |
handler | string | how 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. | |
actions | array<string> | allowed actions for this item (e.g. approve, reject, decide, contest). Each action produces a decided change-request โ decision โ receipt. | |
source | string | the solution/component that raised it | |
status | string | ||
tenant | string | ||
created_at | string | โ |