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

# List processes

> Returns process snapshots filtered by optional ref, state, and status query parameters. The status filter accepts the terminal exit states (success, failed, timeout, canceled) or 'null' to match processes that have not finished.



## OpenAPI

````yaml /cyrnel/openapi.json get /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:
    get:
      tags:
        - Processes
      summary: List processes
      description: >-
        Returns process snapshots filtered by optional ref, state, and status
        query parameters. The status filter accepts the terminal exit states
        (success, failed, timeout, canceled) or 'null' to match processes that
        have not finished.
      parameters:
        - schema:
            type: string
            description: Optional reference string used to filter processes.
          required: false
          description: Optional reference string used to filter processes.
          name: ref
          in: query
        - schema:
            type: string
            enum:
              - queued
              - running
              - idle
              - terminating
            description: Current lifecycle state of a process.
          required: false
          description: Current lifecycle state of a process.
          name: state
          in: query
        - schema:
            type: string
            enum:
              - failed
              - success
              - timeout
              - canceled
              - 'null'
            description: >-
              Filter processes by terminal exit state. Use 'null' to match
              processes that have not finished.
          required: false
          description: >-
            Filter processes by terminal exit state. Use 'null' to match
            processes that have not finished.
          name: status
          in: query
      responses:
        '200':
          description: Matching processes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProcessListResponse'
        '400':
          description: One or more query parameters 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'
        '500':
          description: The process list could not be loaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ProcessListResponse:
      type: object
      properties:
        processes:
          type: array
          items:
            $ref: '#/components/schemas/Process'
          description: Processes that match the provided query filters.
      required:
        - processes
      description: Collection wrapper for process listings.
    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.
    Process:
      type: object
      properties:
        id:
          type: integer
          minimum: 0
          exclusiveMinimum: true
          description: >-
            Stable process identifier assigned at creation. Persists across
            restarts.
        ref:
          type: string
          minLength: 1
          description: >-
            Optional caller-supplied reference string used to correlate related
            processes.
        state:
          type: string
          enum:
            - queued
            - running
            - idle
            - terminating
          description: Current lifecycle state of the process.
        exitState:
          type: string
          nullable: true
          enum:
            - failed
            - success
            - timeout
            - canceled
            - null
          description: >-
            Terminal exit state of the process. Null until the process becomes
            idle.
        error:
          type: string
          nullable: true
          description: >-
            Error message captured during execution, or null if no error
            occurred.
        createdAt:
          type: string
          description: ISO-8601 timestamp of when the process was created.
        completedAt:
          type: string
          nullable: true
          description: >-
            ISO-8601 timestamp of when the process completed, or null if still
            running.
      required:
        - id
        - state
        - exitState
        - error
        - createdAt
        - completedAt
      description: Process snapshot returned by the process management endpoints.

````