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

# Create a process

> Creates a new process with the supplied source code and optional execution options. If autorun is true (the default), the process begins execution immediately.



## OpenAPI

````yaml /cyrnel/openapi.json post /processes
openapi: 3.0.0
info:
  title: Cyrnel API
  description: >-
    Cyrnel is a universal layer that connects AI agents and LLM applications to
    any external service, API, or device regardless of protocol or standard. It
    acts as an adaptive bridge between your AI and the outside world, enabling
    seamless integrations through code execution, async operation handling, and
    built-in observability and security controls.
  version: 1.0.0
servers:
  - url: http://localhost:9371
security: []
paths:
  /processes:
    post:
      tags:
        - Processes
      summary: Create a process
      description: >-
        Creates a new process with the supplied source code and optional
        execution options. If autorun is true (the default), the process begins
        execution immediately.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProcessCreateRequest'
      responses:
        '201':
          description: Process created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProcessCreatedResponse'
        '400':
          description: The request body could not be parsed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: A bearer token was required but missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '429':
          description: >-
            Rate limit exceeded. The request was throttled. Check Retry-After
            header.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Maximum requests allowed in the current window.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: integer
              description: Unix timestamp when the window resets.
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponse'
        '500':
          description: The process could not be created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ProcessCreateRequest:
      type: object
      properties:
        code:
          type: string
          maxLength: 102400
          description: >-
            Executable source code to stage and run in the active environment
            (max 100 KB).
        ref:
          type: string
          minLength: 1
          description: Optional reference label used for filtering and correlation.
        options:
          type: object
          properties:
            timeout:
              type: integer
              nullable: true
              minimum: 0
              exclusiveMinimum: true
              description: >-
                Execution timeout in milliseconds. Use null to explicitly clear
                the timeout.
          description: Optional execution options for the process.
        autorun:
          type: boolean
          default: true
          description: >-
            Whether to start execution immediately. When false, the process is
            created in idle state and must be started via the run signal.
      required:
        - code
      description: Request body used to create a new process.
    ProcessCreatedResponse:
      type: object
      properties:
        id:
          type: integer
          minimum: 0
          exclusiveMinimum: true
          description: Stable process identifier assigned to the newly created process.
      required:
        - id
      description: Response returned after a process is created.
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message returned by the API.
      required:
        - error
      description: Standard error envelope returned by the HTTP error middleware.
    RateLimitErrorResponse:
      type: object
      properties:
        error:
          type: string
          enum:
            - rate_limit_exceeded
          description: Error code identifying rate-limit rejection.
        message:
          type: string
          description: Human-readable message with retry instructions.
        retryAfter:
          type: integer
          minimum: 0
          exclusiveMinimum: true
          description: Number of seconds to wait before retrying.
      required:
        - error
        - message
        - retryAfter
      description: Error body returned when a request is rate-limited (HTTP 429).

````