BrainstormRouter Guardrails API

The guardrails API from BrainstormRouter — 19 operation(s) for guardrails.

Operations 27

GET /auth/guardrails/catalog Guardrail check registry — tenant-agnostic catalog #
GET /auth/guardrails/config Get the caller tenant's guardrail config #
PUT /auth/guardrails/config Update the caller tenant's guardrail config #
POST /auth/guardrails/feedback Submit guardrail feedback (false-positive / true-positive) #
GET /auth/guardrails/metrics Per-scanner guardrail run/pass/fail/error metrics + feedback summary #
GET /auth/guardrails/pipelines List V2 guardrail pipelines for the tenant #
POST /auth/guardrails/pipelines Create a new V2 guardrail pipeline #
DELETE /auth/guardrails/pipelines/{id} Delete a V2 guardrail pipeline #
PUT /auth/guardrails/pipelines/{id} Update an existing V2 guardrail pipeline #
POST /auth/guardrails/pipelines/{id}/test Execute a pipeline against a sample text — returns the check verdicts #
GET /v1/guardrails/catalog List checks in the V2 guardrail registry #
GET /v1/guardrails/catalog/{checkId} Get a single check definition #
GET /v1/guardrails/config Get the tenant guardrail pipeline config #
PUT /v1/guardrails/config Update the tenant guardrail pipeline config #
POST /v1/guardrails/feedback Submit false-positive / true-positive feedback for a guardrail scan #
GET /v1/guardrails/metrics Aggregated scan + feedback metrics (security_events or in-memory) #
GET /v1/guardrails/pipelines List tenant V2 guardrail pipelines #
POST /v1/guardrails/pipelines Create a V2 guardrail pipeline #
DELETE /v1/guardrails/pipelines/{id} Delete a V2 guardrail pipeline #
GET /v1/guardrails/pipelines/{id} Get a V2 guardrail pipeline by id #
PUT /v1/guardrails/pipelines/{id} Update a V2 guardrail pipeline #
POST /v1/guardrails/pipelines/{id}/test Test a V2 guardrail pipeline against sample text #
GET /v1/guardrails/providers List built-in + external guardrail providers #
POST /v1/guardrails/providers Register an external guardrail provider #
DELETE /v1/guardrails/providers/{id} Remove an external guardrail provider #
GET /v1/guardrails/templates List well-known provider templates #
POST /v1/guardrails/test Run text through the guardrail pipeline (testing/preview) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/brainstormrouter-com:brainstormrouter-com-guardrails-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

brainstormrouter-com-guardrails-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: BrainstormRouter Guardrails API
  version: 1.0.0
  description: 'Autonomous AI API Engine — multi-tenant gateway that intelligently routes

    AI traffic across providers with built-in memory, cost optimization, and

    autonomous background processing.


    All `/v1/*` endpoints require an API key via `Authorization: Bearer `.'
  contact:
    name: BrainstormRouter
    url: https://brainstormrouter.com
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
- url: https://api.brainstormrouter.com
  description: Production
security:
- BearerAuth: []
tags:
- name: guardrails
paths:
  /auth/guardrails/catalog:
    get:
      operationId: authGuardrailsCatalog
      summary: Guardrail check registry — tenant-agnostic catalog
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.catalog
      x-br-version: v1
      parameters:
      - name: category
        in: query
        required: false
        schema:
          type: string
      - name: phase
        in: query
        required: false
        schema:
          type: string
      - name: pricing
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/guardrails/config:
    get:
      operationId: authGuardrailsConfigGet
      summary: Get the caller tenant's guardrail config
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.config.get
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
    put:
      operationId: authGuardrailsConfigUpdate
      summary: Update the caller tenant's guardrail config
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.config.update
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                enabled:
                  type: boolean
                mode:
                  type: string
                  enum:
                  - block
                  - warn
                  - log
                confidenceThreshold:
                  type: number
                providers:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                      enabled:
                        type: boolean
                    required:
                    - id
                    - enabled
                    additionalProperties: false
              required:
              - enabled
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/guardrails/feedback:
    post:
      operationId: authGuardrailsFeedback
      summary: Submit guardrail feedback (false-positive / true-positive)
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.feedback
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                requestId:
                  type: string
                falsePositive:
                  type: boolean
                scannerId:
                  type: string
                notes:
                  type: string
              required:
              - requestId
              - falsePositive
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/guardrails/metrics:
    get:
      operationId: authGuardrailsMetrics
      summary: Per-scanner guardrail run/pass/fail/error metrics + feedback summary
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.metrics
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/guardrails/pipelines:
    get:
      operationId: authGuardrailsPipelinesList
      summary: List V2 guardrail pipelines for the tenant
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.pipelines.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
    post:
      operationId: authGuardrailsPipelinesCreate
      summary: Create a new V2 guardrail pipeline
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.pipelines.create
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                name:
                  type: string
                enabled:
                  default: true
                  type: boolean
                defaultOnFail:
                  default: block
                  type: string
                  enum:
                  - block
                  - log
                  - warn
                confidenceThreshold:
                  default: 0.7
                  type: number
                timeoutMs:
                  default: 5000
                  type: number
                onTimeout:
                  default: fail-closed
                  type: string
                  enum:
                  - fail-closed
                  - fail-open
                allowMutation:
                  default: false
                  type: boolean
                checks:
                  type: array
                  items:
                    type: object
                    properties:
                      checkId:
                        type: string
                      params:
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                      id:
                        type: string
                    additionalProperties: false
              required:
              - name
              - enabled
              - defaultOnFail
              - confidenceThreshold
              - timeoutMs
              - onTimeout
              - allowMutation
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/guardrails/pipelines/{id}:
    delete:
      operationId: authGuardrailsPipelinesDelete
      summary: Delete a V2 guardrail pipeline
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.pipelines.delete
      x-br-version: v1
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
    put:
      operationId: authGuardrailsPipelinesUpdate
      summary: Update an existing V2 guardrail pipeline
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.pipelines.update
      x-br-version: v1
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                name:
                  type: string
                enabled:
                  type: boolean
                defaultOnFail:
                  type: string
                  enum:
                  - block
                  - log
                  - warn
                confidenceThreshold:
                  type: number
                timeoutMs:
                  type: number
                onTimeout:
                  type: string
                  enum:
                  - fail-closed
                  - fail-open
                allowMutation:
                  type: boolean
                checks:
                  type: array
                  items:
                    type: object
                    properties:
                      checkId:
                        type: string
                      params:
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                      id:
                        type: string
                    additionalProperties: false
              required: []
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /auth/guardrails/pipelines/{id}/test:
    post:
      operationId: authGuardrailsPipelinesTest
      summary: Execute a pipeline against a sample text — returns the check verdicts
      tags:
      - guardrails
      x-br-capability-id: auth.guardrails.pipelines.test
      x-br-version: v1
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              properties:
                text:
                  type: string
              required:
              - text
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - SupabaseJwt: []
  /v1/guardrails/catalog:
    get:
      operationId: systemGuardrailsCatalogList
      summary: List checks in the V2 guardrail registry
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.catalog.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/catalog/{checkId}:
    get:
      operationId: systemGuardrailsCatalogGet
      summary: Get a single check definition
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.catalog.get
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/config:
    get:
      operationId: systemGuardrailsConfigGet
      summary: Get the tenant guardrail pipeline config
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.config.get
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    put:
      operationId: systemGuardrailsConfigSet
      summary: Update the tenant guardrail pipeline config
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.config.set
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              propertyNames:
                type: string
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/feedback:
    post:
      operationId: systemGuardrailsFeedback
      summary: Submit false-positive / true-positive feedback for a guardrail scan
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.feedback
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              propertyNames:
                type: string
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/metrics:
    get:
      operationId: systemGuardrailsMetrics
      summary: Aggregated scan + feedback metrics (security_events or in-memory)
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.metrics
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/pipelines:
    get:
      operationId: systemGuardrailsPipelinesList
      summary: List tenant V2 guardrail pipelines
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.pipelines.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    post:
      operationId: systemGuardrailsPipelinesCreate
      summary: Create a V2 guardrail pipeline
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.pipelines.create
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              propertyNames:
                type: string
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/pipelines/{id}:
    delete:
      operationId: systemGuardrailsPipelinesDelete
      summary: Delete a V2 guardrail pipeline
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.pipelines.delete
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    get:
      operationId: systemGuardrailsPipelinesGet
      summary: Get a V2 guardrail pipeline by id
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.pipelines.get
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    put:
      operationId: systemGuardrailsPipelinesUpdate
      summary: Update a V2 guardrail pipeline
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.pipelines.update
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              propertyNames:
                type: string
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/pipelines/{id}/test:
    post:
      operationId: systemGuardrailsPipelinesTest
      summary: Test a V2 guardrail pipeline against sample text
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.pipelines.test
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              propertyNames:
                type: string
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/providers:
    get:
      operationId: systemGuardrailsProvidersList
      summary: List built-in + external guardrail providers
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.providers.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
    post:
      operationId: systemGuardrailsProvidersCreate
      summary: Register an external guardrail provider
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.providers.create
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              propertyNames:
                type: string
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/providers/{id}:
    delete:
      operationId: systemGuardrailsProvidersDelete
      summary: Remove an external guardrail provider
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.providers.delete
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/templates:
    get:
      operationId: systemGuardrailsTemplatesList
      summary: List well-known provider templates
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.templates.list
      x-br-version: v1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
  /v1/guardrails/test:
    post:
      operationId: systemGuardrailsTest
      summary: Run text through the guardrail pipeline (testing/preview)
      tags:
      - guardrails
      x-br-capability-id: system.guardrails.test
      x-br-version: v1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              type: object
              propertyNames:
                type: string
              additionalProperties: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-07/schema#
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
      security:
      - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key (e.g. `br_live_...`)
    SupabaseJWT:
      type: http
      scheme: bearer
      description: Supabase JWT token (dashboard auth)