> ## 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.

# Create execution

> Execute a workflow. Returns immediately with an execution ID.



## OpenAPI

````yaml /openapi.yaml post /workflows/{workflowId}/executions
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:
    post:
      tags:
        - Executions
      summary: Create execution
      description: Execute a workflow. Returns immediately with an execution ID.
      operationId: createExecution
      parameters:
        - name: workflowId
          in: path
          required: true
          description: Workflow ID
          schema:
            type: string
            format: uuid
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  additionalProperties: {}
                  description: >-
                    Input data for the workflow execution. Must match the
                    workflow's input_schema if defined.
              additionalProperties: false
              description: Request body for creating a new workflow execution
      responses:
        '200':
          description: Execution created
          content:
            application/json:
              schema:
                type: object
                properties:
                  execution_id:
                    type: string
                    format: uuid
                    description: Unique identifier for the created execution
                  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
                required:
                  - execution_id
                  - workflow_id
                  - status
                  - created_at
                additionalProperties: false
                description: Response after successfully creating a workflow execution
        '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.

````