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

# List model providers

> The model providers this deployment can connect, and their defaults.



## OpenAPI

````yaml /openapi.json get /v1/model-connectors
openapi: 3.1.0
info:
  title: Gobare Agent API
  version: v1
  description: >-
    Programmatic access to Gobare coding-agent sessions. Conceptually aligned
    with OpenAI's Agents API; deliberately not wire-compatible with it. See the
    divergence list in the product documentation.
servers:
  - url: https://api.{domain}
    variables:
      domain:
        default: gobare.dev
security: []
paths:
  /v1/model-connectors:
    get:
      summary: List model providers
      description: The model providers this deployment can connect, and their defaults.
      operationId: get_model_connectors
      responses:
        '200':
          description: The model providers this deployment can connect, and their defaults.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelConnectorCatalog'
        '400':
          description: >-
            `invalid_request`. A query parameter this endpoint does not take.
            Refused rather than ignored, because an ignored filter answers with
            everything and looks like a filter that matched.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            No such endpoint, or the public API is not enabled on this
            deployment.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: An unexpected error. Quote the request id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security: []
components:
  schemas:
    ModelConnectorCatalog:
      type: object
      required:
        - object
        - data
      description: >-
        The model providers this deployment can connect. Served without a token,
        like the OpenAPI document: it describes what the API supports rather
        than anything inside an organization.
      properties:
        object:
          type: string
          const: list
          description: >-
            Always `list`. Names the shape, so a value can be identified without
            knowing which call returned it.
        data:
          type: array
          items:
            $ref: '#/components/schemas/ModelConnector'
    Error:
      type: object
      required:
        - error
      description: Every refusal this API makes, in one shape.
      properties:
        error:
          description: Always present on a failure, and the only thing present.
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
              enum:
                - invalid_request
                - authentication_error
                - permission_denied
                - not_found
                - method_not_allowed
                - conflict
                - queue_full
                - rate_limit_exceeded
                - project_limit_exceeded
                - context_length_exceeded
                - provider_error
                - provider_unauthorized
                - sandbox_error
                - sandbox_unavailable
                - directory_unavailable
                - workspace_recovery_failed
                - bridge_incompatible
                - internal_error
            message:
              type: string
            request_id:
              type: string
              description: >-
                Also on the x-request-id header. Quote it when reporting a
                problem.
    ModelConnector:
      type: object
      required:
        - object
        - id
        - display_name
        - protocol
      properties:
        object:
          type: string
          const: model_connector
          description: >-
            Always `model_connector`. Names the shape, so a value can be
            identified without knowing which call returned it.
        id:
          type: string
          description: What to send as `provider` when connecting a key.
        display_name:
          type: string
        default_model:
          type:
            - string
            - 'null'
          description: >-
            What you get by omitting `model`, and what `agent.model` must match
            unless you name another.
        key_prefix:
          type:
            - string
            - 'null'
          description: >-
            How this vendor's keys begin. Several vendors share `sk-`, which is
            why connecting one of those asks for `provider` — this is how you
            tell which ids collide before sending a secret.
        key_url:
          type:
            - string
            - 'null'
          description: Where to get a key.
        protocol:
          type: string
          enum:
            - anthropic
            - openai
          description: >-
            The wire protocol, which decides what a custom `base_url` must
            speak.
        default_base_url:
          type:
            - string
            - 'null'

````