Pin or update work-item focus

Pins, reprioritizes, snoozes, annotates, or clears a work item from personal/team focus views. Focus does not mutate authoritative schedule or staffing.

POST/api/v1/work-items/:id/focus

Authorization

work-items:focusapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Canonical work-item ID

Example: work_01k2...

Request body

actionstringoptional"pin" | "update" | "clear"

Focus command

prioritynumberoptional

Focus priority

reasonstringoptional

Reason shown in focus views

notesstringoptional

Internal focus note

expires_atstringoptional

Optional expiration timestamp

confirmbooleanrequired

Must be true

Example request

{
  "action": "pin",
  "priority": 10,
  "reason": "Customer escalation",
  "confirm": true
}

Request

POST /api/v1/work-items/:id/focus

curl -X POST "https://www.digitalstack360.com/api/v1/work-items/work_01k2.../focus" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Idempotency-Key: work-42-focus-v1" \
  -H "Content-Type: application/json" \
  -d '{"action":"pin","priority":10,"reason":"Customer escalation","confirm":true}'

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

Response

200 OK

{
  "data": {
    "focus": {
      "id": "focus_01k7...",
      "priority": 10,
      "reason": "Customer escalation"
    },
    "changed_fields": [
      "focus"
    ]
  }
}

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

403

scope_insufficient

Key lacks work-items:focus scope

400

focus_not_allowed

Focus command is not allowed