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

# List Guardrails

> Return all guardrail rows ordered by position then sort_order.



## OpenAPI

````yaml /standalone/openapi.json get /admin/api/v1/guardrails
openapi: 3.1.0
info:
  title: Idun Agent Engine Server
  description: A production-ready server for conversational AI agents
  version: 0.6.1
servers: []
security: []
tags:
  - name: Runtime
    description: >-
      Public agent run endpoints, engine operations, and chat-channel webhooks.
      SSE streaming via the AG-UI protocol.
  - name: Agent Configuration
    description: >-
      Singleton admin endpoints for the agent, prompts, memory, guardrails, and
      onboarding wizard.
  - name: Auth & SSO
    description: >-
      Login, sessions, password change, SSO config, and the public SSO discovery
      endpoint.
  - name: Integrations & Tools
    description: MCP server registry and external integration credentials.
  - name: Observability
    description: Tracing/logging provider configuration.
  - name: Traces
    description: >-
      Trace and span storage admin endpoints — list, detail, delete, and
      pipeline-health for the standalone trace store.
  - name: Dashboard
    description: >-
      Operator dashboard widgets — KPIs, time-series, top errors, and
      configuration summary.
paths:
  /admin/api/v1/guardrails:
    get:
      tags:
        - Agent Configuration
      summary: List Guardrails
      description: Return all guardrail rows ordered by position then sort_order.
      operationId: list_guardrails_admin_api_v1_guardrails_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/StandaloneGuardrailRead'
                type: array
                title: Response List Guardrails Admin Api V1 Guardrails Get
components:
  schemas:
    StandaloneGuardrailRead:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        slug:
          type: string
          title: Slug
        name:
          type: string
          title: Name
        enabled:
          type: boolean
          title: Enabled
        position:
          type: string
          enum:
            - input
            - output
          title: Position
        sortOrder:
          type: integer
          minimum: 0
          title: Sortorder
        guardrail:
          anyOf:
            - $ref: '#/components/schemas/SimpleBanListConfig'
            - $ref: '#/components/schemas/SimplePIIConfig'
            - $ref: '#/components/schemas/SimpleNSFWTextConfig'
            - $ref: '#/components/schemas/SimpleToxicLanguageConfig'
            - $ref: '#/components/schemas/SimpleGibberishTextConfig'
            - $ref: '#/components/schemas/SimpleBiasCheckConfig'
            - $ref: '#/components/schemas/SimpleCompetitionCheckConfig'
            - $ref: '#/components/schemas/SimpleCorrectLanguageConfig'
            - $ref: '#/components/schemas/SimpleRestrictToTopicConfig'
          title: Guardrail
        createdAt:
          type: string
          format: date-time
          title: Createdat
        updatedAt:
          type: string
          format: date-time
          title: Updatedat
      type: object
      required:
        - id
        - slug
        - name
        - enabled
        - position
        - sortOrder
        - guardrail
        - createdAt
        - updatedAt
      title: StandaloneGuardrailRead
      description: GET response and the data payload of POST/PATCH/DELETE responses.
    SimpleBanListConfig:
      properties:
        config_id:
          type: string
          const: ban_list
          title: Config Id
          default: ban_list
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        banned_words:
          items:
            type: string
          type: array
          title: Banned Words
          description: A list of strings (words or phrases) to block
      type: object
      required:
        - banned_words
      title: SimpleBanListConfig
    SimplePIIConfig:
      properties:
        config_id:
          type: string
          const: detect_pii
          title: Config Id
          default: detect_pii
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        pii_entities:
          items:
            type: string
          type: array
          title: Pii Entities
          description: List of PII entity types to detect
      type: object
      required:
        - pii_entities
      title: SimplePIIConfig
    SimpleNSFWTextConfig:
      properties:
        config_id:
          type: string
          const: nsfw_text
          title: Config Id
          default: nsfw_text
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for NSFW content
      type: object
      required:
        - threshold
      title: SimpleNSFWTextConfig
    SimpleToxicLanguageConfig:
      properties:
        config_id:
          type: string
          const: toxic_language
          title: Config Id
          default: toxic_language
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for toxic language
      type: object
      required:
        - threshold
      title: SimpleToxicLanguageConfig
    SimpleGibberishTextConfig:
      properties:
        config_id:
          type: string
          const: gibberish_text
          title: Config Id
          default: gibberish_text
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for gibberish detection
      type: object
      required:
        - threshold
      title: SimpleGibberishTextConfig
    SimpleBiasCheckConfig:
      properties:
        config_id:
          type: string
          const: bias_check
          title: Config Id
          default: bias_check
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for bias detection
      type: object
      required:
        - threshold
      title: SimpleBiasCheckConfig
    SimpleCompetitionCheckConfig:
      properties:
        config_id:
          type: string
          const: competition_check
          title: Config Id
          default: competition_check
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        competitors:
          items:
            type: string
          type: array
          title: Competitors
          description: Names of competitor companies or products
      type: object
      required:
        - competitors
      title: SimpleCompetitionCheckConfig
    SimpleCorrectLanguageConfig:
      properties:
        config_id:
          type: string
          const: correct_language
          title: Config Id
          default: correct_language
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        expected_languages:
          items:
            type: string
          type: array
          title: Expected Languages
          description: Valid ISO language codes (e.g., en, fr, es)
      type: object
      required:
        - expected_languages
      title: SimpleCorrectLanguageConfig
    SimpleRestrictToTopicConfig:
      properties:
        config_id:
          type: string
          const: restrict_to_topic
          title: Config Id
          default: restrict_to_topic
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ''
        valid_topics:
          items:
            type: string
          type: array
          title: Valid Topics
          description: Topics the agent is allowed to discuss
        invalid_topics:
          items:
            type: string
          type: array
          title: Invalid Topics
          description: Topics the agent must refuse
      type: object
      title: SimpleRestrictToTopicConfig

````