Skip to content
Hexel StudioDocs

Attention inbox

List the questions your agents asked you and the Titan approvals waiting on you, in one call.

The attention inbox lists what waits on you in the current workspace and environment: your tasks' unanswered questions and, with your Titan user-route token, the Titan approvals waiting on you.

Bash
hexel harness attention                       # questions only
export HEXEL_USER_ROUTE_TOKEN="..."
hexel harness attention                       # questions and approvals

GET /harness/attention needs harness:task:read. Send your Titan user-route token in X-Titan-User-Token to include approvals (Approvals and autonomy).

JSON
{
  "items": [
    {"kind": "question", "source": "harness", "id": "call_123", "task_id": "tsk_123",
     "run_id": "run_789", "created_at": "2026-11-17T09:00:00Z", "prompt_digest": "hmac-sha256:..."},
    {"kind": "approval", "source": "titan", "id": "apr_456", "task_id": "tsk_124", "state": "pending",
     "capability": "harness.sandbox.shell", "operation": "...", "expires_at": "2026-11-17T10:00:00Z",
     "created_at": "2026-11-17T09:05:00Z"}
  ],
  "sources": {"harness": "ok", "titan": "ok"}
}
  • Questions: unanswered questions on tasks you created in this environment that are not finished. Answer one with hexel harness answer or POST /harness/questions/{id}/answer. A question's prompt is content, so the inbox shows its digest; the prompt itself is in the task's live stream.
  • Approvals: Titan's pending approvals for sessions that act for you, in this workspace and environment. Titan decides which you see. task_id is set when one of your tasks waits on it; decide it with hexel harness approve or POST /harness/tasks/{id}/approvals/{approval}.
  • Oldest first, at most 100 of each.

sources.titan says how the approvals part went. Titan's part never fails the request:

ValueMeaning
okApprovals are included.
token_requiredNo Titan token was sent.
token_mismatchThe token is not yours; nothing from it is shown.
token_rejectedTitan refused the token.
unavailable, not_configuredTitan could not be asked.