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

# Send unload signal

> Removes an idle process from active memory, keeping its database record and outputs intact. The process id remains valid and can be revived later via the run signal. Returns a conflict when the process is not idle or is not in active memory.



## OpenAPI

````yaml /openapi.json post /processes/{id}/signals/unload
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/{id}/signals/unload:
    post:
      tags:
        - Processes
      summary: Send unload signal
      description: >-
        Removes an idle process from active memory, keeping its database record
        and outputs intact. The process id remains valid and can be revived
        later via the run signal. Returns a conflict when the process is not
        idle or is not in active memory.
      parameters:
        - schema:
            type: string
            description: Numeric process identifier serialized as a path parameter.
          required: true
          description: Numeric process identifier serialized as a path parameter.
          name: id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProcessKillRequest'
      responses:
        '200':
          description: The process was unloaded from active memory.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Process'
        '400':
          description: The request body or id path parameter was invalid.
          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'
        '404':
          description: The process could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '409':
          description: The process is not idle or is not in active memory.
          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 unloaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ProcessKillRequest:
      type: object
      additionalProperties:
        nullable: true
      description: >-
        Any JSON object. The payload is ignored and only object-ness is
        validated.
    Process:
      type: object
      properties:
        id:
          type: integer
          minimum: 0
          exclusiveMinimum: true
          description: >-
            Stable process identifier assigned at creation. Persists across
            restarts.
        pid:
          type: integer
          nullable: true
          minimum: 0
          exclusiveMinimum: true
          description: >-
            Ephemeral in-memory process identifier, or null when the process is
            not in active memory.
        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
        - pid
        - state
        - exitState
        - error
        - createdAt
        - completedAt
      description: Process snapshot returned by the process management endpoints.
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message returned by the API.
        code:
          type: string
          description: >-
            Stable machine-readable error code (e.g. invalid_cursor,
            cursor_expired).
      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).

````