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

# Set Org Approved Models

> Replace your organization's approved models. Each modality you send replaces that modality's list, and any modality you omit is cleared, so send every modality you want to keep. Entries can be `provider/model` names or model IDs. Every model used by one of your access lists must stay approved, otherwise the request fails with 400. Send every modality empty to remove the allowlist and allow every model in the catalog. Requires an API key with write manage permissions.

Replace your organization's approved models. Each modality you send replaces that modality's list and any modality you omit is cleared, so send every modality you want to keep. Every model used by one of your access lists must stay approved. Send every modality empty to allow every model in the catalog.

[Approved Models docs →](/features/approved-models)


## OpenAPI

````yaml POST /v1/manage/org/approved-model
openapi: 3.0.3
info:
  title: Requesty Management API
  description: >-
    Requesty Management API for API key management, groups, members, and
    organization settings.
  version: 1.0.0
servers:
  - url: https://api-v2.requesty.ai
    description: Management API endpoint
security:
  - BearerAuth: []
paths:
  /v1/manage/org/approved-model:
    servers:
      - url: https://api-v2.requesty.ai
        description: Management API endpoint
    post:
      summary: Set org approved models
      description: >-
        Replace your organization's approved models. Each modality you send
        replaces that modality's list, and any modality you omit is cleared, so
        send every modality you want to keep. Entries can be `provider/model`
        names or model IDs. Every model used by one of your access lists must
        stay approved, otherwise the request fails with 400. Send every modality
        empty to remove the allowlist and allow every model in the catalog.
        Requires an API key with write manage permissions.
      operationId: setOrgApprovedModels
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetOrgApprovedModelsRequest'
      responses:
        '200':
          description: Approved models updated successfully
        '400':
          description: >-
            Bad request - unknown model, or a model used by an access list would
            no longer be approved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - missing or invalid Authorization header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - API key does not have write manage permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found - organization does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SetOrgApprovedModelsRequest:
      type: object
      description: >-
        The full set of approved models. Modalities that are omitted are
        cleared.
      properties:
        chat:
          type: array
          items:
            type: string
          description: >-
            Chat/completion models to approve, as `provider/model` names or
            model IDs. Replaces the current list; omitted or empty means no
            chat/completion models are approved unless every modality is empty
          example:
            - openai/gpt-4o
            - anthropic/claude-sonnet-4-20250514
        embedding:
          type: array
          items:
            type: string
          description: >-
            Embedding models to approve, as `provider/model` names or model IDs.
            Replaces the current list; omitted or empty means no embedding
            models are approved unless every modality is empty
          example:
            - openai/text-embedding-3-small
        image:
          type: array
          items:
            type: string
          description: >-
            Image generation models to approve, as `provider/model` names or
            model IDs. Replaces the current list; omitted or empty means no
            image generation models are approved unless every modality is empty
        transcription:
          type: array
          items:
            type: string
          description: >-
            Transcription models to approve, as `provider/model` names or model
            IDs. Replaces the current list; omitted or empty means no
            transcription models are approved unless every modality is empty
        speech:
          type: array
          items:
            type: string
          description: >-
            Speech models to approve, as `provider/model` names or model IDs.
            Replaces the current list; omitted or empty means no speech models
            are approved unless every modality is empty
        decision:
          type: array
          items:
            type: string
          description: >-
            Decision models to approve, as `provider/model` names or model IDs.
            Replaces the current list; omitted or empty means no decision models
            are approved unless every modality is empty
          example:
            - typesafe/jev-latest
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - origin
            - message
          properties:
            origin:
              type: string
              enum:
                - router
                - provider
              description: >-
                Whether the error originated from Requesty's router or an
                upstream provider.
            message:
              type: string
              description: Human-readable error description.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.