---
title: "List all executions"
method: GET
path: "/v1/automations/executions"
tags: ["Automations"]
---

# List all executions

`GET /v1/automations/executions`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/automations/executions`
- Auth: HTTP bearer

Lists runs across every automation you can read, newest first.

## Query parameters

- `page` integer
- `limit` integer
- `status` Status (unresolved $ref)
- `trigger_type` Type (unresolved $ref)
- `created_by_me` boolean
- `search` string

## Headers

- `X-Replicas-Api-Version` '2026-10-07'

## Response `200`

Successful response

- ListOrganizationAutomationExecutionsResponse: Paginated list of executions across accessible automations
  - `executions` AutomationExecutionListItem[], required
    - `id` string, uuid, required: Unique identifier for the execution
    - `automation_id` string, uuid, required: The automation that was executed
    - `organization_id` string, uuid, required: Organization that owns this execution
    - `workspace_id` string, uuid, nullable, required: The workspace created for this execution (null if not yet created)
    - `workspace_name` string, nullable, required: Name of the execution's workspace. Null when `workspace_id` is null or the workspace has been permanently removed.
    - `workspace_deleted` boolean, required: Whether the run's workspace has been deleted.
    - `triggered_at` string, date-time, required: When the execution was triggered
    - `trigger_payload` object, required: Event data that triggered the execution
    - `status` 'pending' | 'creating' | 'running' | 'completed' | 'failed', required: Current status of the execution
    - `config` WorkspaceConfig, required: Workspace behavior configuration. Defaults depend on the workspace source; see each setting.
      - `memoryRetentionEnabled` boolean: Whether sessions are added to session history when the workspace sleeps. Defaults to false for API and automation workspaces.
      - `capabilities` object: Actions this workspace is allowed to perform. Automations snapshot this config onto each workspace they create; API-created workspaces can set it at creation time.
        - `pr_followups` boolean: Whether matching pull requests can receive Replicas follow-up actions. Only applies to workspaces created from an automation, where it defaults to false; other workspaces always receive follow-ups. When enabled, later CI and review-comment replies can route back to this workspace.
        - `read_only_contents` boolean: Whether the workspace GitHub token is restricted to read-only repository contents, keeping write access for pull request comments, issues, and checks. Defaults to false, so the workspace can push branches and open pull requests.
      - `preferences` object: Workspace behavior preferences that do not grant new action permissions.
        - `keep_open_on_pr_merge` boolean: Whether the workspace should remain open after its last tracked PR is merged. Defaults to false.
        - `keep_open_on_pr_close` boolean: Whether the workspace should remain open after its last tracked PR is closed without merging. Defaults to false.
      - `provisioning_error` object: Setup/provisioning or wake/resume failure captured when the workspace remains queryable in `error` status. Some wake/resume failures can be retried; the `error` status can also represent an unrecoverable sandbox failure.
        - `message` string: Underlying setup failure message, such as repository clone/auth errors.
    - `error` string, nullable, required: Error message if the execution failed
    - `completed_at` string, date-time, nullable, required: When the execution completed
    - `can_retry` boolean, required: Whether the execution failed and the caller can write to its automation, so it can be retried
    - `automation_name` string, required: Human-readable name of the automation
  - `total` integer, required: Total number of executions
  - `page` integer, required: Current page number
  - `limit` integer, required: Number of items per page
  - `total_pages` integer, required: Total number of pages

## Other responses

- `400`: Invalid query parameter (e.g. unknown status or trigger_type)
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/replicas/apis/replicas-api.md) - [All operations](https://skmtc.dev/replicas/apis/replicas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/replicas/apis/replicas-api/revisions/2703ac1c9cb7?raw)
