Neo

Lists all agent tasks for the specified organization. Supports pagination via continuationToken with a configurable pageSize (1-1000, default 100). Returns task metadata including ID, name, status, and creation timestamp.

Request Parameters

• orgName string path required
  The organization name
• continuationToken string query optional
  Token for retrieving the next page of results
• pageSize integer query optional
  Number of results per page
• sortBy string query optional
  Field to sort the results by. Defaults to lastEvent.
• sortDirection string query optional
  Direction to sort the results in. Defaults to desc.
• taskType string query optional
  Task type to filter by

Responses

Creates a new agent task for the specified organization. The request must include a prompt (the user event message) that initiates the task. Set the ‘permissionMode’ field in the request body to restrict the agent to read-only operations. Returns the created task details including task ID, name, status, and timestamp.

Request Parameters

• orgName string path required
  The organization name

Request Body

• message AgentUserEventMessage optional
  The message content
• ↳ content string required
  The exact natural language instruction from the user.
• ↳ entity_diff AgentEntityDiff optional
  Entities to add or remove from the agent.
• ↳ commands map[string]AgentSlashCommand optional
  Slash Commands the user selected when creating their message.
• ↳ pageContext PageContext optional
  Optional Pulumi Cloud page the user has the Neo pane open on at the moment they sent this event. Persisted with the event so cold-start replay can reproduce per-turn page context exactly. Omitted by clients with no concept of a current page (CLI, scheduled tasks, Slack, GitHub triggers, API consumers).
• ↳ timestamp string required
  When the event occurred.
• ↳ type string required
• approvalMode enum optional
  Optional approval mode override for this task. If omitted, org default is used.
  Values: manual, auto, balanced
• planMode boolean optional
  Whether to enable plan mode for this task.
• permissionMode enum optional
  Controls the permission scope for the task. When omitted, defaults to ‘default’ (the agent uses the creating user’s full permissions).
  Values: default, read-only
• toolExecutionMode enum optional
  Where tools should be executed. Defaults to ‘cloud’ if omitted.
  Values: cloud, cli
• enabledIntegrations array[AgentTaskIntegrationRef] optional
  Optional list of integrations to enable for this task. Semantics: omitted/null → inherit all org-enabled integrations; empty list → explicit opt-out (no integration credentials for this task); populated list → whitelist of specific integrations by ID. Modeled as an object array rather than a bare string array so multi-instance support (instance_name, scope, etc.) can be added later without a wire break.
• ↳ id string required
  The catalog integration ID (e.g. ‘honeycomb’, ‘datadog’).
• source enum optional
  The origin that triggered this task. Defaults to ‘api’ if omitted.
  Values: api, console, cli, slack, schedule, github
• cliIntegrations array[CLIIntegrationRef] optional
  Optional filter for CLI integrations to enable for this task. Semantics: omitted/null → enable all CLI integrations connected for the org; empty list → explicit opt-out (no CLI integrations for this task); populated list → whitelist by (catalogId, name) of the configured instances to enable. Entries that do not match any connected integration are silently skipped.
• ↳ catalogId string required
  The CLI catalog entry ID (e.g. ‘aws’).
• ↳ name string required
  The user-chosen instance name. Unique within the (org, catalogId) pair.

Responses

Retrieves metadata for a specific agent task, including its ID, name, status, creation timestamp, and associated entities. Returns 404 if the task does not exist.

Request Parameters

• orgName string path required
  The organization name
• taskID string path required
  The agent task identifier

Responses

Sends a response to an ongoing agent task. Supported event types include user_message, user_confirmation, and user_cancel. Returns 409 if the task already has a pending request that has not completed.

Request Parameters

• orgName string path required
  The organization name
• taskID string path required
  The agent task identifier

Request Body

• event AgentUserEvent optional
  The event
• ↳ entity_diff AgentEntityDiff optional
  Entities to add or remove from the agent.
• ↳ pageContext PageContext optional
  Optional Pulumi Cloud page the user has the Neo pane open on at the moment they sent this event. Persisted with the event so cold-start replay can reproduce per-turn page context exactly. Omitted by clients with no concept of a current page (CLI, scheduled tasks, Slack, GitHub triggers, API consumers).
• ↳ timestamp string required
  When the event occurred.
• ↳ type string required

Responses

Updates the settings or metadata of an agent task. Only the user who created the task can modify it.

Request Parameters

• orgName string path required
  The organization name
• taskID string path required
  The agent task identifier

Request Body

• name string optional
  A new display name for the task. Null means no change. Must be between 1 and 255 characters after trimming whitespace.
• isShared boolean optional
  Whether to share the task with other org members. Null means no change.
• approvalMode enum optional
  Approval mode for this task. Null means no change. Valid values: ‘manual’, ‘auto’, ‘balanced’.
  Values: manual, auto, balanced
• permissionMode enum optional
  The permission scope for the task. Null means no change.
  Values: default, read-only

Responses

Cancels an agent task. When force is true, immediately terminates the runtime session and resets the task to idle. This is the escalation path when a graceful cancel (via the user_cancel event in RespondToTask) is insufficient or the task is stuck. Unlike graceful cancel, force-cancel does not attempt to notify the agent runtime — it kills the session directly and resets the task state. Currently only force cancellation is supported; the force field must be set to true. Returns 409 if the session was stopped but the task status could not be reset to idle.

Request Parameters

• orgName string path required
  The organization name
• taskID string path required
  The agent task identifier

Request Body

• force boolean required
  If true, immediately terminate the runtime session and reset the task to idle without attempting a graceful cancel. Required to be true in the current implementation.

Responses

Retrieves the event stream for a specific agent task. Events include agent messages, tool calls, status changes, and user interactions. Supports pagination via continuationToken with a configurable pageSize (1-1000).

Request Parameters

• orgName string path required
  The organization name
• taskID string path required
  The agent task identifier
• continuationToken string query optional
  Token for retrieving the next page of results
• pageSize integer query optional
  Number of results per page

Responses

Streams events for a specific agent task as Server-Sent Events. Each SSE data frame contains a JSON-encoded AgentConsoleEvent. The stream delivers existing events immediately, then keeps the connection open to deliver new events in real time until the task completes.

Request Parameters

• orgName string path required
  The organization name
• taskID string path required
  The agent task identifier

Responses