Regras de gastos
Criar uma regra de gastos
Cria um alerta de gastos, opcionalmente um que bloqueia requisições acima de um limite.
POST
/
spend-rules
Criar uma regra de gastos
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
enabled: true,
scope_id: '<string>',
window_hours: 360,
time_zone: '<string>',
base_amount_usd: 123,
base_amount_nanos: 123,
threshold_percents: [500],
threshold_amount_usd: 123,
threshold_amount_nanos: 123,
runway_days: 183,
spike_multiplier: 123,
spike_floor_usd: 123,
spike_floor_nanos: 123,
block_at_percent: 550,
block_at_amount_usd: 123,
block_at_amount_nanos: 123,
block_free_models: true,
cooldown_minutes: 21602,
destination_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
})
};
fetch('https://api.phaseo.app/v1/spend-rules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.phaseo.app/v1/spend-rules"
payload = {
"name": "<string>",
"enabled": True,
"scope_id": "<string>",
"window_hours": 360,
"time_zone": "<string>",
"base_amount_usd": 123,
"base_amount_nanos": 123,
"threshold_percents": [500],
"threshold_amount_usd": 123,
"threshold_amount_nanos": 123,
"runway_days": 183,
"spike_multiplier": 123,
"spike_floor_usd": 123,
"spike_floor_nanos": 123,
"block_at_percent": 550,
"block_at_amount_usd": 123,
"block_at_amount_nanos": 123,
"block_free_models": True,
"cooldown_minutes": 21602,
"destination_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)curl --request POST \
--url https://api.phaseo.app/v1/spend-rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"enabled": true,
"scope_id": "<string>",
"window_hours": 360,
"time_zone": "<string>",
"base_amount_usd": 123,
"base_amount_nanos": 123,
"threshold_percents": [
500
],
"threshold_amount_usd": 123,
"threshold_amount_nanos": 123,
"runway_days": 183,
"spike_multiplier": 123,
"spike_floor_usd": 123,
"spike_floor_nanos": 123,
"block_at_percent": 550,
"block_at_amount_usd": 123,
"block_at_amount_nanos": 123,
"block_free_models": true,
"cooldown_minutes": 21602,
"destination_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
'package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.phaseo.app/v1/spend-rules"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"enabled\": true,\n \"scope_id\": \"<string>\",\n \"window_hours\": 360,\n \"time_zone\": \"<string>\",\n \"base_amount_usd\": 123,\n \"base_amount_nanos\": 123,\n \"threshold_percents\": [\n 500\n ],\n \"threshold_amount_usd\": 123,\n \"threshold_amount_nanos\": 123,\n \"runway_days\": 183,\n \"spike_multiplier\": 123,\n \"spike_floor_usd\": 123,\n \"spike_floor_nanos\": 123,\n \"block_at_percent\": 550,\n \"block_at_amount_usd\": 123,\n \"block_at_amount_nanos\": 123,\n \"block_free_models\": true,\n \"cooldown_minutes\": 21602,\n \"destination_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.phaseo.app/v1/spend-rules")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"enabled\": true,\n \"scope_id\": \"<string>\",\n \"window_hours\": 360,\n \"time_zone\": \"<string>\",\n \"base_amount_usd\": 123,\n \"base_amount_nanos\": 123,\n \"threshold_percents\": [\n 500\n ],\n \"threshold_amount_usd\": 123,\n \"threshold_amount_nanos\": 123,\n \"runway_days\": 183,\n \"spike_multiplier\": 123,\n \"spike_floor_usd\": 123,\n \"spike_floor_nanos\": 123,\n \"block_at_percent\": 550,\n \"block_at_amount_usd\": 123,\n \"block_at_amount_nanos\": 123,\n \"block_free_models\": true,\n \"cooldown_minutes\": 21602,\n \"destination_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ]\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.phaseo.app/v1/spend-rules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'enabled' => true,
'scope_id' => '<string>',
'window_hours' => 360,
'time_zone' => '<string>',
'base_amount_usd' => 123,
'base_amount_nanos' => 123,
'threshold_percents' => [
500
],
'threshold_amount_usd' => 123,
'threshold_amount_nanos' => 123,
'runway_days' => 183,
'spike_multiplier' => 123,
'spike_floor_usd' => 123,
'spike_floor_nanos' => 123,
'block_at_percent' => 550,
'block_at_amount_usd' => 123,
'block_at_amount_nanos' => 123,
'block_free_models' => true,
'cooldown_minutes' => 21602,
'destination_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.phaseo.app/v1/spend-rules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"enabled\": true,\n \"scope_id\": \"<string>\",\n \"window_hours\": 360,\n \"time_zone\": \"<string>\",\n \"base_amount_usd\": 123,\n \"base_amount_nanos\": 123,\n \"threshold_percents\": [\n 500\n ],\n \"threshold_amount_usd\": 123,\n \"threshold_amount_nanos\": 123,\n \"runway_days\": 183,\n \"spike_multiplier\": 123,\n \"spike_floor_usd\": 123,\n \"spike_floor_nanos\": 123,\n \"block_at_percent\": 550,\n \"block_at_amount_usd\": 123,\n \"block_at_amount_nanos\": 123,\n \"block_free_models\": true,\n \"cooldown_minutes\": 21602,\n \"destination_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"enabled": true,
"metric": "spend",
"evaluated": true,
"scope_type": "workspace",
"scope_id": "<string>",
"period": "day",
"window_hours": 360,
"time_zone": "<string>",
"base_kind": "amount",
"base_ref": "daily",
"base_amount_nanos": 123,
"base_amount_usd": 123,
"threshold_percents": [
500
],
"threshold_amount_nanos": 123,
"threshold_amount_usd": 123,
"runway_days": 183,
"spike_multiplier": 123,
"spike_floor_nanos": 123,
"spike_floor_usd": 123,
"action": "notify",
"block_at_percent": 550,
"block_at_amount_nanos": 123,
"block_at_amount_usd": 123,
"block_free_models": true,
"cooldown_minutes": 21602,
"destination_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "validation_error",
"message": "Unknown parameter: foo",
"type": "invalid_request_error",
"param": "foo"
},
"ok": false,
"code": "validation_error",
"message": "Human-readable error message",
"description": "Additional error details.",
"generation_id": "G-abc123",
"status_code": 502,
"error_type": "system",
"error_origin": "upstream",
"reason": "all_candidates_failed",
"attempt_count": 2,
"failed_providers": [
"google-ai-studio",
"openai"
],
"failed_statuses": [
403,
429
],
"upstream_error": {
"code": "PERMISSION_DENIED",
"message": "The caller does not have permission.",
"description": "<string>",
"param": "<string>"
},
"failure_sample": [
{
"provider": "<string>",
"type": "<string>",
"status": 123,
"upstream_error_code": "<string>",
"upstream_error_message": "<string>",
"upstream_error_description": "<string>",
"upstream_error_param": "<string>",
"upstream_payload_preview": "<string>",
"retryable": true
}
],
"provider_failure_diagnostics": {
"category": "credentials_not_configured",
"hint": "<string>",
"provider": "<string>"
},
"routing_diagnostics": {
"filterStages": [
{
"stage": "<string>",
"beforeCount": 123,
"afterCount": 123,
"droppedProviders": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
}
]
},
"provider_candidate_diagnostics": {
"totalProviders": 123,
"supportsEndpointCount": 123,
"candidateCount": 123,
"droppedUnsupportedEndpoint": [
"<string>"
],
"droppedMissingAdapter": [
{
"providerId": "<string>",
"endpoint": "<string>"
}
]
},
"provider_enablement": {
"capability": "<string>",
"providersBefore": [
"<string>"
],
"providersAfter": [
"<string>"
],
"dropped": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
},
"missing_pricing_providers": [
"<string>"
],
"provider_payment_required_provider": "openai",
"provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
"details": [
{}
]
}Requer
spend_rules:write. Chamadores OAuth precisam ser proprietários ou administradores do espaço de trabalho. Envie cada valor em USD (*_usd) ou em nanodólares (*_nanos), não ambos. Um espaço de trabalho pode ter 50 regras de gastos. Veja o guia de alertas de gastos para as métricas, bases, escopos e períodos.Autorizações
Autenticação com token Bearer
Corpo
application/json
Uma regra de gastos a criar. name, metric e period são obrigatórios. Regras spike usam por padrão um multiplicador de 3x e um piso de US$ 5.
Required string length:
1 - 100spend: o gasto atingiu threshold_amount. budget_percent: o gasto atingiu threshold_percents da base. forecast: o gasto projetado para o fim do período atinge o limite. spike: o gasto nas últimas window_hours é pelo menos spike_multiplier vezes a mediana da mesma janela nos 7 dias anteriores, e pelo menos spike_floor. balance: o saldo ou a autonomia do workspace fica abaixo do limite.
Opções disponíveis:
spend, budget_percent, forecast, spike, balance day, week (a partir de segunda-feira) ou month no fuso horário da regra, ou rolling nas últimas window_hours.
Opções disponíveis:
day, week, month, rolling Opções disponíveis:
workspace, key, member, department, model, provider Null para o escopo do workspace; caso contrário, o ID de uma chave, o ID de usuário de um membro, o ID de um departamento, o ID de um modelo ou o ID de um provedor.
Maximum string length:
200Horas de uma janela rolling: a janela de pico para regras spike (no máximo 56, para que caibam 3 janelas nos 7 dias anteriores) e o período de consumo para regras balance. Nulo para períodos de calendário.
Intervalo obrigatório:
1 <= x <= 720Fuso horário IANA dos períodos de calendário. Null usa o fuso horário de cobrança do workspace.
Maximum string length:
64Do que threshold_percents são porcentagens: amount (base_amount), workspace_budget ou key_limit (o intervalo base_ref, que deve corresponder ao período) ou previous_period.
Opções disponíveis:
amount, workspace_budget, key_limit, previous_period Opções disponíveis:
daily, weekly, monthly Até cinco porcentagens inteiras da base, ordenadas. Cada uma dispara no máximo uma vez por período; se várias forem cruzadas ao mesmo tempo, um único alerta é enviado com a mais alta.
Required array length:
1 - 5 elementsIntervalo obrigatório:
1 <= x <= 1000Intervalo obrigatório:
1 <= x <= 365notify, ou avisar e depois bloquear quando o gasto atingir block_at_percent da base ou block_at_amount. O bloqueio é feito com o melhor esforço e age minutos após o limite. Enquanto o bloqueio estiver desativado no gateway, uma regra que começaria a bloquear é recusada com um 400, e uma regra que já bloqueia apenas avisa.
Opções disponíveis:
notify, block Intervalo obrigatório:
100 <= x <= 1000Se um bloqueio também interrompe solicitações a modelos gratuitos.
Mínimo de minutos entre alertas nas regras rolling, spike e balance.
Intervalo obrigatório:
5 <= x <= 43200Destinos de notificação dos alertas desta regra. Vazio significa a rota de Spend Alerts do workspace.
Maximum array length:
50Resposta
Regra de gastos criada
Uma regra de gastos: limites em dólares ou em porcentagem para um escopo e um período que avisam, ou avisam e depois bloqueiam. Os valores são retornados em nanodólares e em USD.
Show child attributes
Show child attributes
Última modificação em 31 de outubro de 2026
Esta página foi útil?
⌘I
Criar uma regra de gastos
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
enabled: true,
scope_id: '<string>',
window_hours: 360,
time_zone: '<string>',
base_amount_usd: 123,
base_amount_nanos: 123,
threshold_percents: [500],
threshold_amount_usd: 123,
threshold_amount_nanos: 123,
runway_days: 183,
spike_multiplier: 123,
spike_floor_usd: 123,
spike_floor_nanos: 123,
block_at_percent: 550,
block_at_amount_usd: 123,
block_at_amount_nanos: 123,
block_free_models: true,
cooldown_minutes: 21602,
destination_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
})
};
fetch('https://api.phaseo.app/v1/spend-rules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.phaseo.app/v1/spend-rules"
payload = {
"name": "<string>",
"enabled": True,
"scope_id": "<string>",
"window_hours": 360,
"time_zone": "<string>",
"base_amount_usd": 123,
"base_amount_nanos": 123,
"threshold_percents": [500],
"threshold_amount_usd": 123,
"threshold_amount_nanos": 123,
"runway_days": 183,
"spike_multiplier": 123,
"spike_floor_usd": 123,
"spike_floor_nanos": 123,
"block_at_percent": 550,
"block_at_amount_usd": 123,
"block_at_amount_nanos": 123,
"block_free_models": True,
"cooldown_minutes": 21602,
"destination_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)curl --request POST \
--url https://api.phaseo.app/v1/spend-rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"enabled": true,
"scope_id": "<string>",
"window_hours": 360,
"time_zone": "<string>",
"base_amount_usd": 123,
"base_amount_nanos": 123,
"threshold_percents": [
500
],
"threshold_amount_usd": 123,
"threshold_amount_nanos": 123,
"runway_days": 183,
"spike_multiplier": 123,
"spike_floor_usd": 123,
"spike_floor_nanos": 123,
"block_at_percent": 550,
"block_at_amount_usd": 123,
"block_at_amount_nanos": 123,
"block_free_models": true,
"cooldown_minutes": 21602,
"destination_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
'package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.phaseo.app/v1/spend-rules"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"enabled\": true,\n \"scope_id\": \"<string>\",\n \"window_hours\": 360,\n \"time_zone\": \"<string>\",\n \"base_amount_usd\": 123,\n \"base_amount_nanos\": 123,\n \"threshold_percents\": [\n 500\n ],\n \"threshold_amount_usd\": 123,\n \"threshold_amount_nanos\": 123,\n \"runway_days\": 183,\n \"spike_multiplier\": 123,\n \"spike_floor_usd\": 123,\n \"spike_floor_nanos\": 123,\n \"block_at_percent\": 550,\n \"block_at_amount_usd\": 123,\n \"block_at_amount_nanos\": 123,\n \"block_free_models\": true,\n \"cooldown_minutes\": 21602,\n \"destination_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.phaseo.app/v1/spend-rules")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"enabled\": true,\n \"scope_id\": \"<string>\",\n \"window_hours\": 360,\n \"time_zone\": \"<string>\",\n \"base_amount_usd\": 123,\n \"base_amount_nanos\": 123,\n \"threshold_percents\": [\n 500\n ],\n \"threshold_amount_usd\": 123,\n \"threshold_amount_nanos\": 123,\n \"runway_days\": 183,\n \"spike_multiplier\": 123,\n \"spike_floor_usd\": 123,\n \"spike_floor_nanos\": 123,\n \"block_at_percent\": 550,\n \"block_at_amount_usd\": 123,\n \"block_at_amount_nanos\": 123,\n \"block_free_models\": true,\n \"cooldown_minutes\": 21602,\n \"destination_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ]\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.phaseo.app/v1/spend-rules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'enabled' => true,
'scope_id' => '<string>',
'window_hours' => 360,
'time_zone' => '<string>',
'base_amount_usd' => 123,
'base_amount_nanos' => 123,
'threshold_percents' => [
500
],
'threshold_amount_usd' => 123,
'threshold_amount_nanos' => 123,
'runway_days' => 183,
'spike_multiplier' => 123,
'spike_floor_usd' => 123,
'spike_floor_nanos' => 123,
'block_at_percent' => 550,
'block_at_amount_usd' => 123,
'block_at_amount_nanos' => 123,
'block_free_models' => true,
'cooldown_minutes' => 21602,
'destination_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.phaseo.app/v1/spend-rules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"enabled\": true,\n \"scope_id\": \"<string>\",\n \"window_hours\": 360,\n \"time_zone\": \"<string>\",\n \"base_amount_usd\": 123,\n \"base_amount_nanos\": 123,\n \"threshold_percents\": [\n 500\n ],\n \"threshold_amount_usd\": 123,\n \"threshold_amount_nanos\": 123,\n \"runway_days\": 183,\n \"spike_multiplier\": 123,\n \"spike_floor_usd\": 123,\n \"spike_floor_nanos\": 123,\n \"block_at_percent\": 550,\n \"block_at_amount_usd\": 123,\n \"block_at_amount_nanos\": 123,\n \"block_free_models\": true,\n \"cooldown_minutes\": 21602,\n \"destination_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"enabled": true,
"metric": "spend",
"evaluated": true,
"scope_type": "workspace",
"scope_id": "<string>",
"period": "day",
"window_hours": 360,
"time_zone": "<string>",
"base_kind": "amount",
"base_ref": "daily",
"base_amount_nanos": 123,
"base_amount_usd": 123,
"threshold_percents": [
500
],
"threshold_amount_nanos": 123,
"threshold_amount_usd": 123,
"runway_days": 183,
"spike_multiplier": 123,
"spike_floor_nanos": 123,
"spike_floor_usd": 123,
"action": "notify",
"block_at_percent": 550,
"block_at_amount_nanos": 123,
"block_at_amount_usd": 123,
"block_free_models": true,
"cooldown_minutes": 21602,
"destination_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "validation_error",
"message": "Unknown parameter: foo",
"type": "invalid_request_error",
"param": "foo"
},
"ok": false,
"code": "validation_error",
"message": "Human-readable error message",
"description": "Additional error details.",
"generation_id": "G-abc123",
"status_code": 502,
"error_type": "system",
"error_origin": "upstream",
"reason": "all_candidates_failed",
"attempt_count": 2,
"failed_providers": [
"google-ai-studio",
"openai"
],
"failed_statuses": [
403,
429
],
"upstream_error": {
"code": "PERMISSION_DENIED",
"message": "The caller does not have permission.",
"description": "<string>",
"param": "<string>"
},
"failure_sample": [
{
"provider": "<string>",
"type": "<string>",
"status": 123,
"upstream_error_code": "<string>",
"upstream_error_message": "<string>",
"upstream_error_description": "<string>",
"upstream_error_param": "<string>",
"upstream_payload_preview": "<string>",
"retryable": true
}
],
"provider_failure_diagnostics": {
"category": "credentials_not_configured",
"hint": "<string>",
"provider": "<string>"
},
"routing_diagnostics": {
"filterStages": [
{
"stage": "<string>",
"beforeCount": 123,
"afterCount": 123,
"droppedProviders": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
}
]
},
"provider_candidate_diagnostics": {
"totalProviders": 123,
"supportsEndpointCount": 123,
"candidateCount": 123,
"droppedUnsupportedEndpoint": [
"<string>"
],
"droppedMissingAdapter": [
{
"providerId": "<string>",
"endpoint": "<string>"
}
]
},
"provider_enablement": {
"capability": "<string>",
"providersBefore": [
"<string>"
],
"providersAfter": [
"<string>"
],
"dropped": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
},
"missing_pricing_providers": [
"<string>"
],
"provider_payment_required_provider": "openai",
"provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
"details": [
{}
]
}