> ## 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 Executions Across Automations

> Returns a paginated list of execution history across organization automations and personal automations accessible to the authenticated user.



## OpenAPI

````yaml /openapi.json get /v1/automations/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. `/v1/replica` endpoints accept
      API keys and workspace engine-secret authentication; user-session JWTs are
      not accepted.
  - 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: Slack
    description: Connect Slack identities and route threads to Replicas workspaces
  - name: Linear
    description: Connect Linear identities to Replicas accounts
  - 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: Media
    description: >-
      Read workspace media and obtain short-lived download or inline preview
      URLs
  - 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.
  - name: Plugins
    description: >-
      Install and manage native and Composio-backed workspace plugins. An
      organization admin installs a plugin for the whole organization, or a
      member installs it personally; inside a workspace a personal connection
      takes precedence over the organization one.
paths:
  /v1/automations/executions:
    get:
      tags:
        - Automation
      summary: List Executions Across Automations
      description: >-
        Returns a paginated list of execution history across organization
        automations and personal automations accessible to the authenticated
        user.
      operationId: listOrganizationAutomationExecutions
      parameters:
        - name: page
          in: query
          description: Page number for pagination
          required: false
          schema:
            type: integer
            minimum: 1
            default: 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/ListOrganizationAutomationExecutionsResponse
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ListOrganizationAutomationExecutionsResponse:
      type: object
      description: Paginated list of executions across accessible automations
      properties:
        executions:
          type: array
          items:
            $ref: '#/components/schemas/AutomationExecutionListItem'
        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
    AutomationExecutionListItem:
      allOf:
        - $ref: '#/components/schemas/AutomationExecutionRecord'
        - type: object
          properties:
            automation_name:
              type: string
              description: Human-readable name of the automation
          required:
            - automation_name
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type:
            - string
            - 'null'
          description: Additional error details
      required:
        - error
    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_deleted:
          type: boolean
          description: >-
            Whether the workspace for this execution has since been deleted.
            Deleted workspaces are no longer retrievable, so treat
            `workspace_id` as a historical reference when this is true. Always
            false when `workspace_id` is null.
        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
        - workspace_deleted
        - triggered_at
        - trigger_payload
        - status
        - config
        - error
        - completed_at
    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.
            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'
    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. User-session JWTs are not
        accepted by `/v1/replica` endpoints.

````