Get single attention item

GET /api/v1/attention/{item_id}

Fetch a single attention item (inbox or live) by its prefixed ID. Optionally marks it read/dismissed.

Operation ID: get_attention_item_api_v1_attention__item_id__get · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

item_id string required

Query

auto_mark_read boolean default: True
client_view boolean default: False

Responses

200 Successful Response

Schema: AttentionItem

id string required

Opaque identifier. Format: inbox:<uuid> for persistent messages or live:<alert_id> for computed signals.

source AttentionSource requiredAttentionSource
category AttentionCategory requiredAttentionCategory
priority AttentionPriority requiredAttentionPriority
title string required
body string

Optional longer description of the item.

icon string

Icon hint for the frontend (CSS icon name).

action_required boolean

Whether resolving this item requires user action. Items with action_required=True appear in the Action Items dashboard card; all items appear in the notification bell.

action_url string

In-app deep link the user should follow to resolve.

action_label string

Short label for the action button (e.g. 'Review').

entity_type string

Related entity kind, e.g. invoices, bills.

entity_id string

Related entity ID if applicable.

created_at string · date-time required
read boolean

True if the item is read (inbox) or has been dismissed by the user (live).

starred boolean

Inbox-only star state.

dismissible boolean

Whether the user can mark this read/dismiss. Always true for inbox; live items are dismissible per-user via user.props.

metadata object

Optional source-specific extra data.

401 Unauthorized - Authentication required

404 Not Found - Resource does not exist

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError
5 fields
loc array · string | integer required
msg string required
type string required
input object
ctx object