Record a Today attention-item action

Records a confirmed action against one generated Today attention item and emits the corresponding durable webhook fact. This does not mutate project schedules, work items, or source-system records.

POST/api/v1/me/today/attention-items/:id/actions

Authorization

agent:readapi key scoperequired

Required scope when calling with an API key.

agent:context_querysession capabilityoptional

Required capability when calling with a signed-in session.

Path parameters

idstringrequired

Attention item UUID returned by myDay / meta.my_day.attentionItems

Example: b1259ce1-bf47-5a54-8d71-b9b2f4e83ed3

Request body

actionstringrequired"resolve" | "dismiss" | "snooze"

Lifecycle action to record.

notestringoptional

Optional operator note. Keep receiver behavior idempotent; notes are informational.

snooze_untilstringoptional

Required when action=snooze. ISO-8601 timestamp.

context_package_generated_atstringoptional

generatedAt/provenance timestamp from the package the item came from.

confirmbooleanrequired

Must be true.

Example request

{
  "action": "resolve",
  "note": "Handled during morning standup",
  "context_package_generated_at": "2026-07-15T13:00:00Z",
  "confirm": true
}

Request

POST /api/v1/me/today/attention-items/:id/actions

curl -X POST "https://www.digitalstack360.com/api/v1/me/today/attention-items/b1259ce1-bf47-5a54-8d71-b9b2f4e83ed3/actions" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"resolve","note":"Handled during morning standup","context_package_generated_at":"2026-07-15T13:00:00Z","confirm":true}'

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "attentionItemId": "b1259ce1-bf47-5a54-8d71-b9b2f4e83ed3",
    "action": "resolve",
    "eventType": "attention_item.resolved",
    "occurredAt": "2026-07-15T13:22:04Z"
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

400

bad_request

Missing or invalid request fields

403

scope_insufficient

Key lacks the required write scope

400

invalid_action

action is not resolve, dismiss, or snooze

400

confirmation_required

confirm must be true

400

snooze_until_required

snooze_until is required when action=snooze