> ## Documentation Index > Fetch the complete documentation index at: https://docs.replicas.dev/llms.txt > Use this file to discover all available pages before exploring further. # List automation executions ## OpenAPI ````yaml /openapi.json get /v1/automations/{id}/executions openapi: 3.1.0 info: title: Replicas API version: 2.0.0 description: >- Create and control workspaces, and manage the environments, automations, and learnings they run with. servers: - url: https://api.replicas.dev description: Production API security: - apiKey: [] tags: - name: Replica description: >- A replica is a Replicas workspace: a cloud sandbox where a coding agent works on your repositories. - name: Chats description: Manage the agent chats inside a replica. - name: Message queue description: Messages waiting for the agent to finish its turn. - name: Commands and terminals description: Run commands and open shells in a replica. - name: Pull requests description: Inspect and act on pull requests a replica opened. - name: Previews description: Public URLs for ports in a replica. - name: Canvas description: Plans, reports, and other files agents produce. - name: Sharing description: Add replicas to members' Shared view. - name: Environments description: >- Environments define what a workspace starts with. The `global` environment applies to every workspace. - name: Environment variables description: Variables injected into workspaces. - name: Environment files description: Files written into workspaces. - name: Environment skills description: Agent skills installed into workspaces. - name: Environment MCPs description: MCP servers available to workspace agents. - name: Hooks description: Scripts that run when warm pool snapshots build and when workspaces start. - name: Warm pools description: Pre-built workspaces that start faster. - name: Automations description: Run agents on schedules and events. - name: Repositories description: Repositories and repository sets connected to the organization. - name: Learnings description: Organization skills every workspace agent loads. - name: Agent credentials description: >- API keys and endpoints that coding agents use. Connect Claude, Codex, and Muse subscriptions with the CLI. - name: Plugins description: Connect integrations that workspace agents can use. - name: Organization description: Who you are and who is in your organization. - name: Media description: Screenshots, recordings, and other files workspaces produce. - name: Slack description: Route Slack threads to workspaces. - name: Workspace identity description: OIDC keys for verifying workspace identity tokens. paths: /v1/automations/{id}/executions: get: tags: - Automations summary: List automation executions operationId: listAutomationExecutions parameters: - name: id in: path description: The unique identifier of the automation required: true schema: type: string format: uuid - name: page in: query description: Page number for pagination required: false schema: type: integer default: 1 minimum: 1 - name: limit in: query description: Number of items per page required: false schema: type: integer default: 20 minimum: 1 maximum: 100 - $ref: '#/components/parameters/ApiVersion' responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/ListAutomationExecutionsResponse' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: parameters: ApiVersion: name: X-Replicas-Api-Version in: header description: >- API version. `2026-10-07` returns `snake_case` responses. See [versioning](/features/api#versioning). required: false schema: type: string enum: - '2026-10-07' schemas: ListAutomationExecutionsResponse: type: object description: Paginated list of automation executions properties: executions: type: array items: $ref: '#/components/schemas/AutomationExecutionRecord' total: type: integer description: Total number of executions page: type: integer description: Current page number limit: type: integer description: Number of items per page total_pages: type: integer description: Total number of pages required: - executions - total - page - limit - total_pages AutomationExecutionRecord: type: object description: A record of a single automation execution properties: id: type: string format: uuid description: Unique identifier for the execution automation_id: type: string format: uuid description: The automation that was executed organization_id: type: string format: uuid description: Organization that owns this execution workspace_id: type: - string - 'null' format: uuid description: The workspace created for this execution (null if not yet created) workspace_name: type: - string - 'null' description: >- Name of the execution's workspace. Null when `workspace_id` is null or the workspace has been permanently removed. workspace_deleted: type: boolean description: Whether the run's workspace has been deleted. triggered_at: type: string format: date-time description: When the execution was triggered trigger_payload: type: object description: Event data that triggered the execution additionalProperties: true status: type: string description: Current status of the execution enum: - pending - creating - running - completed - failed config: $ref: '#/components/schemas/WorkspaceConfig' error: type: - string - 'null' description: Error message if the execution failed completed_at: type: - string - 'null' format: date-time description: When the execution completed can_retry: type: boolean description: >- Whether the execution failed and the caller can write to its automation, so it can be retried required: - id - automation_id - organization_id - workspace_id - workspace_name - workspace_deleted - triggered_at - trigger_payload - status - config - error - completed_at - can_retry Error: type: object properties: error: type: string description: Error message details: type: - string - 'null' description: Additional error details code: type: string description: Machine-readable error code when available required: - error WorkspaceConfig: type: object description: >- Workspace behavior configuration. Defaults depend on the workspace source; see each setting. properties: memoryRetentionEnabled: type: boolean description: >- Whether sessions are added to session history when the workspace sleeps. Defaults to false for API and automation workspaces. capabilities: type: object description: >- 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. properties: pr_followups: type: boolean description: >- 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: type: boolean description: >- 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. additionalProperties: true preferences: type: object description: >- Workspace behavior preferences that do not grant new action permissions. properties: keep_open_on_pr_merge: type: boolean description: >- Whether the workspace should remain open after its last tracked PR is merged. Defaults to false. default: false keep_open_on_pr_close: type: boolean description: >- Whether the workspace should remain open after its last tracked PR is closed without merging. Defaults to false. default: false additionalProperties: true provisioning_error: type: object description: >- 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. properties: message: type: string description: >- Underlying setup failure message, such as repository clone/auth errors. additionalProperties: true additionalProperties: true responses: Unauthorized: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: http scheme: bearer description: Organization or personal API key from **Settings → API Keys**. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.