API reference · API
Opt the test in to auto savings, or out
POST/v1/shadow/{id}/autoAPI key
Chat scope. {"enabled": true} lets the gateway make the switch itself once a candidate is ready, to the ready candidate with the lowest measured cost ratio, and only one below 1; shadow.auto_switched fires when it does. A test opted in while a candidate is already ready is switched at once. Each Monday the requests a standing switch moved the week before are reported in savings and as shadow.savings_report. Revert takes the opt in back. Audited. A 404 at every path while the operator has not turned shadow testing on.
Parameters
| Field | Type | What it is |
|---|---|---|
| id (path)required | string |
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| enabledrequired | boolean |
Example
{
"enabled": false
}Answer 200
The test, with auto and any switch made.
| Field | Type | What it is |
|---|---|---|
| id | string | shd_ and 24 hex digits. |
| object | "shadow.test" | |
| name | string | |
| model | string | |
| scope | string | One of "key", "account". |
| key_id | integer or null | |
| status | string | One of "active", "stopped". |
| stopped_reason | string or null | |
| held_until | integer or null | Unix seconds: the month's ceiling is reached, nothing runs before this. |
| sample_rate | number | |
| daily_cap | integer | |
| sampled_today | integer | |
| monthly_ceiling_micros | integer | |
| month_spent_micros | integer | |
| month_reserved_micros | integer | |
| spent_micros | integer | |
| compare | object | |
| threshold | number | |
| min_samples | integer | |
| candidates | array of object | |
| candidates[] | string | |
| candidates[] | boolean | |
| switch | object or null | The switch standing, if any: the candidate and the keys it routes. |
| switch. | string | |
| switch. | array of integer | |
| switch. | integer | |
| switch. | boolean | Made by the gateway under auto savings. |
| auto | object | Auto savings: whether the gateway may switch this test itself once a candidate is ready. |
| auto. | boolean | |
| auto. | integer or null | |
| auto. | integer or null | |
| auto. | string or null | |
| auto. | string or null | Why it is off when it was on: turned off, reverted, or why a switch failed. |
| savings | array of object | The newest weekly reports (Monday to Monday, UTC) of what a standing switch saved: the requests it moved, read from their usage rows, what they were billed, and what they would have cost on the original at the report's measured cost ratio. |
| savings[] | integer | |
| savings[] | string | |
| savings[] | string | |
| savings[] | boolean | |
| savings[] | integer | |
| savings[] | integer | |
| savings[] | integer | |
| savings[] | integer | |
| savings[] | number | |
| created_at | integer | |
| updated_at | integer |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 404OpenAI shaped error.
- 409OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.