UpdateTask

Approval mode for this task. Null means no change. Valid values: 'manual', 'auto', 'balanced'.

Whether to share the task with other org members. Null means no change.

A new display name for the task. Null means no change. Must be between 1 and 255 characters after trimming whitespace.

The permission scope for the task. Null means no change.

The RBAC role the task assumes, identified by role id. Null means no change. An empty string clears the assumed role, so subsequent turns run with the task owner's own permissions. A non-empty value must identify a role that exists in the organization and is assigned to you, directly or through a team; a role you do not hold is rejected with a 403. A changed role takes effect starting with the next turn of the conversation.

The Custom Agent definition this task was run as, if any. Null for tasks run by a user directly rather than as a saved agent.

Approval mode for this task. Valid values: 'manual', 'auto', 'balanced'.

The async trigger source for this task. Null for sync tasks.

Percentage of the context window (1-100) at which the agent triggers conversation compaction. Populated alongside contextWindowTokens when token usage data is available; omitted otherwise.

Total input tokens consumed across all model invocations for this task. Approximate context window usage.

Maximum context window size in tokens for the primary model used by this task.

When the task was created, in ISO 8601 format.

Unique identifier for the task.

Whether this task is shared with other org members.

When the task runtime last reported a heartbeat. Null if the runtime has never checked in.

Display name for the task, typically auto-generated from the initial user message.

The number of pending inputs waiting behind this task. Present for tasks that can receive asynchronous inputs.

The permission scope for the task.

Whether the task is in plan mode. Set based on the first user message.

The id of the RBAC role this task assumes. Null when the task runs with the creating user's own permissions (no assumed role).

The display name of the RBAC role this task assumes. Null when the task has no assumed role or the role no longer exists.

The current runtime phase for this task. Null until the runtime checks in.

When the task was first shared. Null if never shared.

The origin that triggered this task. Valid values: 'console', 'cli', 'slack', 'schedule', 'api', 'github', 'code-review'.

The automation that spawned this task, if the task was created by an automation run.

Current execution status of the task.

Whether the task was started synchronously by a user or asynchronously by background automation.

Total Neo tokens consumed across all model invocations for this task. Neo tokens are the priced unit used for billing — distinct from the raw model input tokens surfaced in contextUsedTokens / contextWindowTokens.

Where tools are executed for this task. Valid values: 'cloud', 'cli'.

The version control system this task operates against. Set for tasks that target a specific VCS platform (e.g. code reviews). Null for tasks with no VCS context.