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

> Create a new workflow and start the planning agent.
The planning agent will design and build the workflow based on your prompt.
Returns immediately with a URL to view progress in the Felix UI.




## OpenAPI

````yaml /openapi.yaml post /workflows
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:
    post:
      tags:
        - Workflows
      summary: Create workflow
      description: >
        Create a new workflow and start the planning agent.

        The planning agent will design and build the workflow based on your
        prompt.

        Returns immediately with a URL to view progress in the Felix UI.
      operationId: createWorkflow
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
              properties:
                prompt:
                  type: string
                  minLength: 1
                  description: >-
                    The main workflow description — what should this workflow
                    do? The planning agent will use this to design and build the
                    workflow.
                name:
                  type: string
                  minLength: 1
                  description: Workflow name. Defaults to auto-generated.
                description:
                  type: string
                  description: Workflow description.
      responses:
        '200':
          description: Workflow created and planning started
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - name
                  - description
                  - url
                  - status
                  - created_at
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique workflow identifier
                  name:
                    type: string
                    description: Workflow name
                  description:
                    type: string
                    description: Workflow description
                  url:
                    type: string
                    format: uri
                    description: URL to view the workflow in the Felix UI
                  status:
                    type: string
                    enum:
                      - planning
                    description: Workflow status — the planning agent has been started
                  created_at:
                    type: string
                    format: date-time
                    description: Timestamp when the workflow was created
        '400':
          description: Bad request - missing or invalid prompt
          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
        '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
        '403':
          description: Forbidden - organization over billing limit
          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.

````