> ## Documentation Index
> Fetch the complete documentation index at: https://felix.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get execution

> Retrieve the status and details of an execution



## OpenAPI

````yaml /openapi.yaml get /workflows/{workflowId}/executions/{executionId}
openapi: 3.0.3
info:
  title: Felix API
  description: >
    Programmatic access to Felix workflows.


    Felix lets you describe workflows in natural language and get automation
    that works.

    Use this API to create, manage, and execute workflows programmatically.


    ## Limitations


    - **Request body size**: Maximum 4MB per request

    - **Rate limiting**: 100 requests per minute per API key

    - **Pagination**: List endpoints return up to 100 items per request

    - **Execution timeout**: Workflows have a maximum execution time of 15
    minutes

    - **Concurrent executions**: Maximum 10 concurrent executions per workflow
  version: 1.0.0
servers:
  - url: https://felix.so/api/v1
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Workflows
    description: Manage workflows
  - name: Executions
    description: Run workflows and retrieve results
paths:
  /workflows/{workflowId}/executions/{executionId}:
    get:
      tags:
        - Executions
      summary: Get execution
      description: Retrieve the status and details of an execution
      operationId: getExecution
      parameters:
        - name: workflowId
          in: path
          required: true
          description: Workflow ID
          schema:
            type: string
            format: uuid
        - name: executionId
          in: path
          required: true
          description: Execution ID
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Execution details
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique execution identifier
                  workflow_id:
                    type: string
                    format: uuid
                    description: ID of the workflow being executed
                  status:
                    type: string
                    enum:
                      - initial
                      - processing
                      - human_in_the_loop
                      - finished
                      - error
                    description: Current execution status
                  created_at:
                    type: string
                    format: date-time
                    description: Timestamp when the execution was created
                  url:
                    type: string
                    format: uri
                    description: URL to view the execution in the Felix UI
                  retry_after_seconds:
                    type: number
                    description: >-
                      Suggested polling interval in seconds. Present when
                      execution is not yet finished (status is initial or
                      processing).
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        filename:
                          type: string
                          description: >-
                            Name of the output file (e.g., 'summary.md',
                            'report.csv', 'dashboard.html')
                        url:
                          type: string
                          format: uri
                          description: >-
                            Presigned URL to download the file (expires in 1
                            hour)
                        content:
                          type: string
                          description: >-
                            Inline file content for text-based files under 100KB
                            (.md, .json, .txt, .csv, .html, etc.)
                      required:
                        - filename
                        - url
                      additionalProperties: false
                    nullable: true
                    description: >-
                      Output files from the workflow's last step. Null if
                      execution is not finished.
                required:
                  - id
                  - workflow_id
                  - status
                  - created_at
                  - results
                additionalProperties: false
                description: >-
                  Detailed workflow execution information. When status is
                  initial or processing, includes retry_after_seconds as a
                  polling hint.
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Human-readable error message describing what went wrong
                required:
                  - error
                additionalProperties: false
                description: Standard error response returned when an API request fails
        '404':
          description: Not found - resource doesn't exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Human-readable error message describing what went wrong
                required:
                  - error
                additionalProperties: false
                description: Standard error response returned when an API request fails
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key authentication. Get your key from Settings → API Keys.

````