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

# List model configurations

> Lists production-ready configuration revisions compatible with a reference model. Specify the model with `referenceModel` or the deprecated `referenceModelId`; if both are supplied, they must identify the same model. Results include public configurations and configurations owned by the specified project.



## OpenAPI

````yaml GET /projects/{projectId}/configs
openapi: 3.1.0
info:
  title: Together APIs
  description: The Together REST API. See https://docs.together.ai for more details.
  version: 2.0.0
  termsOfService: https://www.together.ai/terms-of-service
  contact:
    name: Together Support
    url: https://www.together.ai/contact
  license:
    name: MIT
    url: https://github.com/togethercomputer/openapi/blob/main/LICENSE
servers:
  - url: https://api.together.ai/v1
    description: Default environment for APIs
  - url: https://api-inference.together.ai/v2
    description: Optimized environment for inference
security:
  - bearerAuth: []
paths:
  /projects/{projectId}/configs:
    get:
      tags:
        - ConfigService
      summary: List model configurations
      description: >-
        Lists production-ready configuration revisions compatible with a
        reference model. Specify the model with `referenceModel` or the
        deprecated `referenceModelId`; if both are supplied, they must identify
        the same model. Results include public configurations and configurations
        owned by the specified project.
      operationId: ConfigService_ListProjectConfigs
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            description: Project identifier.
            type: string
        - name: referenceModelId
          in: query
          schema:
            type: string
            description: >-
              Deprecated. Use `referenceModel`. Reference model identifier
              filter; if both are set, they must agree.
        - name: referenceModel
          in: query
          schema:
            type: string
            description: >-
              Model resource-name filter using
              `projects/{projectId}/models/{modelId}`; alternative to
              `referenceModelId`. If both are set, they must agree.
        - name: limit
          in: query
          schema:
            type: integer
            description: Maximum number of results to return.
        - name: after
          in: query
          schema:
            type: string
            description: Cursor from a previous list response.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DE.ListProjectConfigsResponse'
        default:
          description: Default error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorData'
      servers:
        - url: https://api.together.ai/v2
components:
  schemas:
    DE.ListProjectConfigsResponse:
      type: object
      description: Model-compatible config revisions and pagination metadata.
      required:
        - data
        - object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/DE.ModelConfig'
          description: The list of model configs.
        next_cursor:
          type: string
          description: Cursor for the next page. Null if there are no more results.
        object:
          const: list
          description: Object type. Always `list`.
    ErrorData:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              nullable: false
            type:
              type: string
              nullable: false
            param:
              type: string
              nullable: true
              default: null
            code:
              type: string
              nullable: true
              default: null
          required:
            - type
            - message
    DE.ModelConfig:
      type: object
      required:
        - id
        - certifications
        - referenceModelId
        - selectors
        - projectId
        - referenceModel
      properties:
        id:
          type: string
          description: Config revision identifier.
        certifications:
          type: array
          items:
            $ref: '#/components/schemas/DE.Certification'
          description: >-
            Model, hardware, and runtime combinations certified for this config
            revision.
        referenceModelId:
          type: string
          description: Deprecated. Use `referenceModel`. Reference model identifier.
        selectors:
          type: array
          items:
            $ref: '#/components/schemas/DE.Selector'
          description: Hardware and runtime selectors used to place and configure replicas.
        projectId:
          type: string
          description: >-
            ID of the project that owns the config revision. Public configs may
            be owned by a different project than the deployment.
        referenceModel:
          type: string
          description: >-
            Resource name of the referenced model, using
            `projects/{modelProject}/models/{modelId}`.
        draftModel:
          type: string
          description: >-
            Resource name of the draft model, using
            `projects/{draftProject}/models/{modelId}`; empty when speculative
            decoding is not enabled.
      description: >-
        Immutable, user-facing configuration revision that defines how a
        compatible model runs, including engine and hardware selectors.
    DE.Certification:
      type: object
      required:
        - target
        - certificationType
        - certifiedAt
        - certifiedBy
        - model
        - modelRevisionId
      properties:
        target:
          enum:
            - CERTIFICATION_TARGET_DE_SERVERLESS
            - CERTIFICATION_TARGET_MRE
          type: string
          description: >-
            Product or serving environment for which the combination was
            evaluated.
        certificationType:
          enum:
            - CERTIFICATION_TYPE_CERTIFIED
            - CERTIFICATION_TYPE_UNCERTIFIED
          type: string
          description: Whether the model and config combination passed certification.
        certifiedAt:
          type: string
          format: date-time
          description: Time when the certification decision was recorded.
        certifiedBy:
          type: string
          description: Service or reviewer that recorded the certification.
        notes:
          type: string
          description: Human-readable certification notes or limitations.
        model:
          type: string
          description: Resource name of the certified model.
        modelRevisionId:
          type: string
          description: Revision identifier of the certified model.
        draftModel:
          type: string
          description: Resource name of the certified draft model.
        draftModelRevisionId:
          type: string
          description: Revision identifier of the certified draft model.
      description: >-
        Certification result for a model, config, and optional draft-model
        combination.
    DE.Selector:
      type: object
      required:
        - key
        - value
      properties:
        key:
          type: string
          description: Selector name, such as GPU type, GPU count, or optimization profile.
        value:
          type: string
          description: Required value for the selector.
      description: Hardware or runtime requirement expressed as a key-value pair.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      x-bearer-format: bearer
      x-default: default

````