1. Docs
2. Reference
3. REST API Docs
4. Schema
5. AgentTask

A Pulumi Copilot agent task representing a conversation and its associated context.

Properties

• id string required
  Unique identifier for the task.
• name string required
  Display name for the task, typically auto-generated from the initial user message.
• taskType enum required
  Whether the task was started synchronously by a user or asynchronously by background automation.
  Values: sync, async
• asyncTriggerType enum optional
  The async trigger source for this task. Null for sync tasks.
  Values: scheduled, external_signal
• status enum required
  Current execution status of the task.
  Values: running, idle
• createdAt string required
  When the task was created, in ISO 8601 format.
• approvalMode enum required
  Approval mode for this task. Valid values: ‘manual’, ‘auto’, ‘balanced’.
  Values: manual, auto, balanced
• entities array[AgentEntity] required
  Pulumi entities (stacks, projects, etc.) that provide context for the agent.
• ↳ type string required
• planMode boolean required
  Whether the task is in plan mode. Set based on the first user message.
• isShared boolean required
  Whether this task is shared with other org members.
• sharedAt string optional
  When the task was first shared. Null if never shared.
• createdBy UserInfo required
  Information about the user who created this task.
• ↳ name string required
  The user’s display name.
• ↳ githubLogin string required
  The user’s login name.
• ↳ avatarUrl string required
  The URL of the user’s avatar image.
• ↳ email string optional
  IMPORTANT: The email address of the user is only included on a few admin-only APIs. For nearly all APIs that return a UserInfo object, this will not be provided. considered sensitive information.
• permissionMode enum optional
  The permission scope for the task.
  Values: default, read-only
• runtimePhase enum optional
  The current runtime phase for this task. Null until the runtime checks in.
  Values: booting, ready, running
• lastHeartbeat string optional
  When the task runtime last reported a heartbeat. Null if the runtime has never checked in.
• contextUsedTokens integer optional
  Total input tokens consumed across all model invocations for this task. Approximate context window usage.
• contextWindowTokens integer optional
  Maximum context window size in tokens for the primary model used by this task.
• contextCompactionThresholdPercent integer optional
  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.
• tokensUsed integer required
  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.
• toolExecutionMode enum optional
  Where tools are executed for this task. Valid values: ‘cloud’, ‘cli’.
  Values: cloud, cli
• sourceAutomationID string optional
  The automation that spawned this task, if the task was created by an automation run.
• source enum optional
  The origin that triggered this task. Valid values: ‘console’, ‘cli’, ‘slack’, ‘schedule’, ‘api’, ‘github’.
  Values: api, console, cli, slack, schedule, github