Report focus state

POST

/api/v1/focus

• Local development server

Reports which project and worktrees a client is actively viewing. Used by the system tray to suppress desktop notifications for focused projects.

Request Body ^required

Focus state report

One of:

object

object

object

Focus state report

object

agentType

AgentType scopes the focus to a specific agent type.

string

clientId

ClientID is a unique identifier for this client instance (UUID per page load or TUI session).

string

focused

Focused is true when the client has visibility focus on Warden.

boolean

projectId

ProjectID is the project being viewed (empty when unfocused or on a non-project page).

string

worktreeIds

WorktreeIDs lists all worktrees currently open in the client’s view.

Array<string>

Responses

204

No Content

400

Bad Request

object

code

string

Allowed values: INVALID_BODY INVALID_CONTAINER_ID INVALID_CONTAINER_NAME INVALID_WORKTREE_ID INVALID_WORKTREE_NAME REQUIRED_FIELD INVALID_PATH INVALID_NETWORK_CONFIG NOT_A_DIRECTORY NOT_FOUND NAME_TAKEN CONTAINER_EXISTS NOT_CONFIGURED STALE_MOUNTS BUDGET_EXCEEDED PROXY_ERROR INTERNAL

error

string