Set Project Model

(v1)

PUT

Sets one of the project's models by the type path segment: evaluation (the LLM judge that scores metrics), platform (powers Confident AI's own AI features), or simulation (simulates user turns in conversation simulations). Setting platform or simulation creates a project override (source becomes project); use DELETE to fall back to the organization default. The provider's credential must already be configured on the project or organization (blocked providers return 403), CONFIDENT_AI needs no credential, and maxInputTokens 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