v1

latestOpenAPI 3.1.02026-07-22106199311.5 KB

AI Agent Tasks

List AI Agent Tasks

Returns a list of AI agent tasks for the account, optionally filtered by project, branch, status, or creation time.

get/v1/ai/agents/tasks

Query parameters

projectIdstring

Filter results to tasks belonging to this project.

branchIdstring

Filter results to tasks belonging to this branch.

status'RUNNING' | 'STOPPED' | 'STOPPING' | 'ERRORED'

Filter results to tasks with the given status.

createdAfterstring date-time

Return only tasks created at or after this ISO-8601 timestamp (inclusive).

createdBeforestring date-time

Return only tasks created at or before this ISO-8601 timestamp (inclusive).

pageinteger

sizeinteger

Response

Agent tasks listed successfully

pageinteger

The current page number (0-indexed)

sizeinteger

The number of tasks per page

totalinteger

The total number of matching tasks

Example response

{
  "tasks": [
    {
      "agentName": "data_engineer_agent",
      "branchId": "main",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "description": "Build a pipeline to load sales data from S3 into Snowflake",
      "mode": "ACT",
      "modifiedAt": "2024-01-15T10:35:00.000Z",
      "projectId": "550e8400-e29b-41d4-a716-446655440001",
      "status": "RUNNING",
      "taskId": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}