---
title: "List all tasks"
method: GET
path: "/genai/{connection_id}/task"
tags: ["genai", "task"]
---

# List all tasks

`GET /genai/{connection_id}/task`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/genai/{connection_id}/task`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `updated_gte` string, date-time
- `sort` 'name' | 'updated_at' | 'created_at'
- `order` 'asc' | 'desc'
- `query` string
- `status` 'PENDING' | 'RUNNING' | 'BLOCKED' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'EXPIRED' | 'OTHER'
- `agent_id` string
- `fields` string[]
- `raw` string

## Response `200`

Successful

- GenaiTask[]
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `name` string: A short human-readable title for the coding agent task.
  - `instructions` string: The natural-language instructions given to the coding agent.
  - `status` 'PENDING' | 'RUNNING' | 'BLOCKED' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'EXPIRED' | 'OTHER'
  - `model_id` string
  - `user_id` string: (reference to HrisEmployee)
  - `repo_url` string: The git repository that the coding agent works in.
  - `source_branch_identifier` string: The name of the branch that the coding agent starts its work from.
  - `target_branch_identifier` string: The name of the branch that the coding agent pushed its work to.
  - `pullrequest_url` string: The pull/merge request that the coding agent opened for its work.
  - `web_url` string: The provider's own web page for this task.
  - `messages` GenaiContent[]: The conversation between the user and the coding agent.
    - `role` 'SYSTEM' | 'USER' | 'ASSISTANT'
    - `content` string, required
    - `images` string[]: Images for the model to evaluate with this message, as base64 data URLs (data:image/png;base64,...). Only for models with has_vision.
  - `summary` string: The coding agent's summary of the work that it performed.
  - `error` string: The failure description (when the status is FAILED).
  - `files_changed` number
  - `lines_added` number
  - `lines_deleted` number
  - `tokens_used` number
  - `started_at` string, date-time: When the coding agent started working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `completed_at` string, date-time: When the coding agent stopped working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `agent_id` string: id of the genai_agent (the reusable agent/preset configuration) that runs this task.
  - `organization_id` string: id of the genai_organization (the organization or execution environment) that this task runs under.
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)