---
title: "List Agent Executions"
method: GET
path: "/api/v1/agent-executions"
tags: ["agent-executions"]
---

# List Agent Executions

`GET /api/v1/agent-executions`

List all agent executions matching the query parameters sorted anti-chronologically by when they were last updated (`updated_at`).

## Query parameters

- `agent_execution_id` string[], nullable
- `agent_id` string[], nullable
- `workspace_id` string[], nullable
- `status` string[], nullable
- `skip` integer
- `limit` integer
- `expand` string[], nullable — total_count: Include the total number of agent executions that match the query, only accurate up to 100.

## Response `200`

Successful Response

- AgentExecutionsListResponse
  - `data` AgentExecution[], required
    - `id` string, uuid4
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `agentId` string, uuid4, required
    - `workspaceId` string, uuid4, required
    - `state` union, required
      - AgentExecutionStatePendingInputs
        - `status` 'PENDING_INPUTS' — The agent is waiting for inputs, e.g., files to be uploaded. An agent may stay in this state in failure cases, e.g., if file upload fails.
      - AgentExecutionStatePendingDataExtraction
        - `status` 'PENDING_DATA_EXTRACTION' — The agent has all inputs at hand and is about to or already extracting data from inputs. An agent may stay in this state in failure cases, e.g., if data extraction fails.
      - AgentExecutionStatePendingReview
        - `status` 'PENDING_REVIEW' — The agent is waiting for the user to review the extracted data. An agent may stay if the user never confirms the data or cancels the execution.
        - `dataExtracted` object, required
      - AgentExecutionStateCanceled
        - `status` 'CANCELED' — The agent execution was canceled by the user.
        - `dataExtracted` object, nullable
      - AgentExecutionStateConfirmed
        - `status` 'CONFIRMED' — The user confirmed the extracted data.
        - `dataExtracted` object, required
        - `dataConfirmed` object, required
      - WorkspacesDomainEntitiesAgentExecutionStateDeliveredToDestination
        - `status` 'DELIVERED_TO_DESTINATION' — The extracted data was successfully delivered to the destination(s), e.g., an AskUI workflow invoked with the data.
        - `dataExtracted` object, required
        - `dataConfirmed` object, required
        - `deliveries` union[]
          - union
            - DataDestinationDeliveryAskUiWorkflow
              - …
            - DataDestinationDeliveryWebhook
              - …
  - `hasMore` boolean — Whether there are more agent executions that match the query that were not included in this response.
  - `totalCount` integer, nullable — The total number of agent executions that match the query, only accurate up to 100.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/askui/apis/askui-workspaces-api.md) · [All operations](https://skmtc.net/askui/apis/askui-workspaces-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/askui/askui-workspaces-api/versions/b796c74292ac/schema)