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

# List error codes

> Retrieves the error codes in the workspace associated with your API key.

Pass `workflow_id` to return only the codes mapped to that workflow — the codes runtime classifies that workflow's errors against. A code is mapped automatically when a node in the saved workflow references its `id`.



## OpenAPI

````yaml workflow-api/workflow-api.yaml get /error-codes
openapi: 3.0.0
info:
  title: Workflow API
  version: 1.0.0
  description: API for managing workflows and their metadata
servers:
  - url: https://api.cloudcruise.com
    description: CloudCruise Platform Production API Server
security:
  - AuthScheme: []
paths:
  /error-codes:
    get:
      summary: List error codes
      description: >-
        Retrieves the error codes in the workspace associated with your API key.


        Pass `workflow_id` to return only the codes mapped to that workflow —
        the codes runtime classifies that workflow's errors against. A code is
        mapped automatically when a node in the saved workflow references its
        `id`.
      operationId: listErrorCodes
      parameters:
        - name: workflow_id
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Only return error codes mapped to this workflow
        - name: cc-key
          in: header
          required: false
          schema:
            type: string
          description: CloudCruise API key for authentication
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ErrorCode'
        '400':
          description: >-
            Bad request - Missing workspace ID or `workflow_id` is not a valid
            UUID
        '401':
          description: Unauthorized - Invalid or missing authentication
        '500':
          description: Internal server error
components:
  schemas:
    ErrorCode:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier. Use this value in a node's error-code parameter.
        error_code:
          type: string
          description: Name of the error code, e.g. `CLAIM_NOT_FOUND`
        description:
          type: string
          nullable: true
          description: Short description of the error
        enriched_description:
          type: string
          nullable: true
          description: Longer description used to classify errors against this code
        error_action:
          type: string
          nullable: true
          enum:
            - alert
            - cancel
            - pause
            - retry
            - input_required
          description: What CloudCruise does when a run fails with this code
        retries:
          type: integer
          nullable: true
          description: Number of retries when `error_action` is `retry`
        retry_after:
          type: integer
          nullable: true
          description: Seconds to wait between retries when `error_action` is `retry`
        workspace_id:
          type: string
          format: uuid
          description: ID of the workspace this error code belongs to
        created_at:
          type: string
          format: date-time
          description: Timestamp when the error code was created
  securitySchemes:
    AuthScheme:
      type: apiKey
      name: cc-key
      in: header
      description: >-
        API key-based authentication. Provide your CloudCruise API key in the
        cc-key header.

````