Set Project Model

PUThttps://api.confident-ai.com/v1/projects/{projectId}/models/{type}

Sets one of the project's models, selected by the type path segment. evaluation configures the LLM judge that scores metrics for this project. platform configures the model that powers Confident AI's own AI features, like classification, summaries, and report generation. simulation configures the model that simulates user turns in conversation simulations, including multi-turn test runs and red teaming. Setting platform or simulation creates a project override, so the project stops following the organization's default and the override toggle in the project's model settings shows as on (source becomes project); remove it with the DELETE method to fall back to the organization default.

The provider's credential must already be configured on the project or the organization; set it first via the model credentials endpoints. Providers blocked by the organization's model provider policy are rejected with a 403. Setting CONFIDENT_AI requires no credential and clears the model name. maxInputTokens applies to the platform and simulation models only and is rejected on the evaluation path.

PUT/v1/projects/{projectId}/models/{type}

curl -X PUT "https://api.confident-ai.com/v1/projects/{projectId}/models/{type}" \
  -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "provider": "OPEN_AI",
  "name": "gpt-4o-mini",
  "maxConcurrency": 10
}'

200

{
  "success": true,
  "data": {
    "model": {
      "id": "cm4xq2j3k0000abcdef123456",
      "type": "EVALUATION",
      "provider": "OPEN_AI",
      "name": "gpt-4o-mini",
      "maxConcurrency": 10,
      "maxInputTokens": null,
      "projectId": "6e0f1c2d-3b4a-4c5d-8e9f-0a1b2c3d4e5f",
      "organizationId": null
    }
  }
}

Headers

CONFIDENT_API_KEYstringRequired
The organization API key for your Confident AI organization.

Path parameters

projectIdstringRequired
The unique identifier of the project.
typeenumRequired
Which of the project's models to set.

Request body

providerenumRequired
The model provider to run the model on. CONFIDENT_AI requires no credential; every other provider requires its credential to be configured first via the model credentials endpoints. The CUSTOM provider cannot be configured through the public API.
Show 16 enum valuesHide 16 enum values
- CONFIDENT_AI
- OPEN_AI
- ANTHROPIC
- GEMINI
- X_AI
- DEEPSEEK
- MISTRAL
- PERPLEXITY
- BEDROCK
- VERTEX_AI
- AZURE
- PORTKEY
- OPEN_ROUTER
- TRUE_FOUNDRY
- LITE_LLM
- HUGGING_FACE
namestring
The model name to use, for example gpt-4o-mini. Omit to clear it; ignored for CONFIDENT_AI.
maxConcurrencyinteger
Maximum number of concurrent calls made to the model. Omit or pass null to clear it.
maxInputTokensinteger
Maximum number of input tokens sent to the model per call. Platform and simulation models only; rejected on the evaluation path. Omit or pass null to clear it.

Response

successboolean
Indicates if the request was successful
dataobject
Show 2 propertiesHide 2 properties
- modelobject
  Show 8 propertiesHide 8 properties
  - idstring
    Unique identifier of the model configuration
  - typeenum
    What the model is used for
    Show 4 enum valuesHide 4 enum values
    EVALUATION
    PLATFORM
    GENERATION
    SIMULATION
  - providerenum
    The model provider to run the model on. CONFIDENT_AI requires no credential; every other provider requires its credential to be configured first via the model credentials endpoints. The CUSTOM provider cannot be configured through the public API.
    Show 16 enum valuesHide 16 enum values
    CONFIDENT_AI
    OPEN_AI
    ANTHROPIC
    GEMINI
    X_AI
    DEEPSEEK
    MISTRAL
    PERPLEXITY
    BEDROCK
    VERTEX_AI
    AZURE
    PORTKEY
    OPEN_ROUTER
    TRUE_FOUNDRY
    LITE_LLM
    HUGGING_FACE
  - namestring
    The configured model name; null when the provider's default is used
  - maxConcurrencyinteger
    Maximum number of concurrent calls made to the model
  - maxInputTokensinteger
    Maximum number of input tokens sent to the model per call
  - projectIdstring
    Set when the model is configured on a project
  - organizationIdstring
    Set when the model is configured on the organization
- sourceenum
  Returned for project reads and for platform and simulation model updates; whether the model in effect comes from a project override or the organization default
  Show 2 enum valuesHide 2 enum values
  - project
  - organization

Built byConfident AI