{"openapi":"3.1.0","info":{"title":"GET /api/v1/attention/{item_id}","version":"1.0.0","description":"Get single attention item"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/attention/{item_id}":{"get":{"tags":["attention"],"summary":"Get single attention item","description":"Fetch a single attention item (inbox or live) by its prefixed ID. Optionally marks it read/dismissed.","operationId":"get_attention_item_api_v1_attention__item_id__get","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}},{"name":"auto_mark_read","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Auto Mark Read"}},{"name":"client_view","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Client View"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttentionItem"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"404":{"description":"Not Found - Resource does not exist","content":{"application/json":{"example":{"detail":"Resource not found"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AttentionCategory":{"type":"string","enum":["action_required","alert","info","announcement","system"],"title":"AttentionCategory","description":"Functional category of an attention item."},"AttentionItem":{"properties":{"id":{"type":"string","title":"Id","description":"Opaque identifier. Format: ``inbox:<uuid>`` for persistent messages or ``live:<alert_id>`` for computed signals."},"source":{"$ref":"#/components/schemas/AttentionSource"},"category":{"$ref":"#/components/schemas/AttentionCategory"},"priority":{"$ref":"#/components/schemas/AttentionPriority"},"title":{"type":"string","title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body","description":"Optional longer description of the item."},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"Icon hint for the frontend (CSS icon name)."},"action_required":{"type":"boolean","title":"Action Required","description":"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.","default":false},"action_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Url","description":"In-app deep link the user should follow to resolve."},"action_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Label","description":"Short label for the action button (e.g. 'Review')."},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type","description":"Related entity kind, e.g. ``invoices``, ``bills``."},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id","description":"Related entity ID if applicable."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"read":{"type":"boolean","title":"Read","description":"True if the item is read (inbox) or has been dismissed by the user (live).","default":false},"starred":{"type":"boolean","title":"Starred","description":"Inbox-only star state.","default":false},"dismissible":{"type":"boolean","title":"Dismissible","description":"Whether the user can mark this read/dismiss. Always true for inbox; live items are dismissible per-user via user.props.","default":true},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Optional source-specific extra data."}},"type":"object","required":["id","source","category","priority","title","created_at"],"title":"AttentionItem","description":"A single thing the user should pay attention to.\n\nThe ``source`` field tells the client whether the item is a real inbox row\n(``inbox``) — which supports archive/star/delete — or a computed live\nsignal (``live``) which can only be read or dismissed."},"AttentionPriority":{"type":"string","enum":["urgent","high","normal","low"],"title":"AttentionPriority","description":"Priority level. Sort order is urgent > high > normal > low."},"AttentionSource":{"type":"string","enum":["inbox","live"],"title":"AttentionSource","description":"Where an attention item came from."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}