# ActUpon full agent guide

ActUpon turns screenshots, voice notes, and similar captures into structured items with explicit next actions.

Authentication:
- Public item and inbox APIs accept standard bearer auth.
- If the bearer token is not a signed-in session JWT, ActUpon checks whether it is a valid personal agent token.
- Current scopes are read_items and update_workflow_status.

Stable public docs:
- Overview: https://thecrux.is/docs - What ActUpon exposes publicly for users, agents, and integrations.
- Quickstart: https://thecrux.is/docs/quickstart - Token model, first API calls, and the shortest path to a working integration.
- Agent Inbox: https://thecrux.is/docs/agent-inbox - How to route captures to Codex, Cursor, or other local agent workflows.
- API: Items: https://thecrux.is/docs/api/items - List and fetch saved ActUpon items, including signed source image URLs.
- API: Inbox: https://thecrux.is/docs/api/inbox - Query pending workflow items for agent-style processing loops.
- API: Agent Tokens: https://thecrux.is/docs/api/agent-tokens - Create scoped personal agent tokens and understand bearer auth.
- Integrations: https://thecrux.is/docs/integrations - Current destination model for Todoist, Linear, Notion, and webhooks.

Key endpoints:
- GET https://thecrux.is/api/screenshotaction/items
- GET https://thecrux.is/api/screenshotaction/items/{id}
- PATCH https://thecrux.is/api/screenshotaction/items/{id}
- GET https://thecrux.is/api/screenshotaction/inbox
- GET https://thecrux.is/api/screenshotaction/agent-tokens
- POST https://thecrux.is/api/screenshotaction/agent-tokens

Agent inbox routing:
- Preferred markers in the ActUpon instruction note are @codex, @codex:<lane>, @cursor, and @cursor:<lane>.
- Matching tags like codex, codex:<lane>, cursor, and cursor:<lane> are also accepted.
- Explicit markers should be preferred over fuzzy note text matching.

OpenAPI: https://thecrux.is/openapi.json