Update the caller's default generation config

POST 
/api/v1/enduser/update-generation-config

Stores the caller's generation preferences. The generation path fills fields left unset by the selected per-send, profile or conversation configuration; already set values remain unchanged. Explicitly present sampling values, including zero, preserve their presence. Model/provider support determines which accepted controls affect a response.

Only user-settable controls are accepted. A recognized operational setting or a model outside the platform allowlist fails the whole request; settings are not silently removed to make a config acceptable. Read the saved profile after an update rather than assuming every submitted setting took effect.

Use this in a guide: Build an agent preferences screen

Request

Responses

200

Default generation config updated

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.

Section ID: DOC-CP-identity-access-api-updateDefaultGenerationConfig#example-end-users-updateDefaultGenerationConfig-request

Request example

{
  "config": {
    "languagePreference": "en-US"
  }
}

Guide request for 3. Offer supported model and response preferences. Replace example resource identifiers with your own authorized values.

Section ID: DOC-CP-identity-access-api-updateDefaultGenerationConfig#example-cookbook-core-platform-identity-access-end-users-03-request

Request example

{
  "config": {
    "model": "google/gemini-3.6-flash",
    "temperature": 0.4,
    "maxOutputTokens": 2048,
    "languagePreference": "es"
  }
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-CP-identity-access-api-updateDefaultGenerationConfig#example-end-users-updateDefaultGenerationConfig-response

Response example

{}

Document ID: DOC-CP-identity-access-api-updateDefaultGenerationConfig. Section identities and revisions.

Section	Stable reference
Update the caller's default generation config	DOC-CP-identity-access-api-updateDefaultGenerationConfig#overview
Request	DOC-CP-identity-access-api-updateDefaultGenerationConfig#request
Responses	DOC-CP-identity-access-api-updateDefaultGenerationConfig#responses