Skip to main content

UpsertFallbackPolicy

POST 

/v1/customers/:customer_id/api-keys/{fallback_policy.target_key_id}/policy/fallback-policies:upsert

UpsertFallbackPolicy replaces the complete set of fallback entries for one organization, project, or API-key target. entries is authoritative: omitted protected models are removed, and an empty set deactivates the target. Release 1 precedence is API key > project > organization/customer; tag targets are reporting-only and cannot be created by this operation. Eligible retry categories are timeout, rate-limit/capacity, and server error. Malformed requests, content refusals, rejected credentials, and other non-eligible client failures do not advance the ordered list. Effective responses and request logs identify the serving model and the source scope/policy. The public names are FallbackPolicy, fallback-policies, entries, and fallback_models; FallbackChainPolicy and chain remain read/write aliases for legacy clients.

Request

Responses

Success