> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryreplicas.com/llms.txt > Use this file to discover all available pages before exploring further. # List Automation Executions > Returns a paginated list of execution history for an automation. ## OpenAPI ````yaml /openapi.json get /v1/automations/{id}/executions openapi: 3.1.0 info: title: Replica API version: 2.0.0 description: >- The Replica API allows you to programmatically manage cloud workspaces for AI agents. Use this API to manage environments (the org-scoped primitive workspaces are created from — including variables, files, skills, MCPs, warm hooks, start hooks, and warm pools), create and manage replicas, send messages, manage chats, stream events, read connected repositories and repository sets, and configure automations. servers: - url: https://api.tryreplicas.com description: Production API security: - apiKey: [] tags: - name: Environments description: >- Manage environments — the primitive that workspaces are created from. Variables, files, skills, MCPs, warm-hooks, and warm-pools are all scoped to an environment. Every organization has a singleton Global environment whose values apply to every workspace. Personal environments are scoped to the authenticated user and can be standalone or source-backed by a team environment. - name: Repository description: >- Read repositories and repository sets connected to your organization. Repositories are the underlying GitHub-connection layer; bind them to an environment to use them in workspaces. - name: Replica description: Manage replicas (workspaces) for AI agents - name: Terminal description: Manage interactive terminal sessions in active workspaces - name: Preview description: Manage public preview URLs for workspace ports - name: Profile description: Read and update the authenticated user's profile - name: Credentials description: >- Manage coding-agent credentials for an organization or the authenticated user - name: Google Search Console description: >- Read Search Console properties, performance, sitemaps, and URL inspection results through a connected Google account - name: Slack description: Route Slack threads to Replicas workspaces - name: Automation description: >- Create and manage automations that trigger replicas on a schedule or in response to events - name: Downloads description: Download Replicas applications - name: Analytics description: >- Read aggregated activity and usage metrics for your organization: compute minutes, workspaces created by source, and pull request throughput over a time range. - name: Presence description: >- Read and report ephemeral member presence: who is online, where they are (environment or workspace), and whether they are typing. Presence is backed by short-lived keys rather than the database and broadcast to other members over the events stream. paths: /v1/automations/{id}/executions: get: tags: - Automation summary: List Automation Executions description: Returns a paginated list of execution history for an automation. 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 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: 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 totalPages: type: integer description: Total number of pages required: - executions - total - page - limit - totalPages 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) 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 required: - id - automation_id - organization_id - workspace_id - triggered_at - trigger_payload - status - config - error - completed_at Error: type: object properties: error: type: string description: Error message details: type: - string - 'null' description: Additional error details required: - error WorkspaceConfig: type: object description: >- Workspace behavior configuration. Missing capabilities and preferences default to disabled. properties: capabilities: type: object description: >- Actions this workspace is allowed to perform. Automations snapshot this config onto each workspace they create; API-created replicas can set it at creation time. properties: pr_followups: type: boolean description: >- Whether matching pull requests can receive Replicas follow-up actions. Defaults to true for workspaces created from the dashboard, Slack, Linear, GitHub, or the API, and to false for workspaces created from an automation. When enabled, later CI and review-comment replies can route back to this workspace. 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: >- API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys. ````