API ReferenceModels

Api Models Status Create

POST for filtering - delegate to GET (BE conventions).

Authentication

AuthorizationBearer
JWT access token or Respan API key

Path parameters

model_namestringRequired

Request

This endpoint expects an object.
start_timestringRequired>=1 character
end_timestringRequired>=1 character
provider_idstring or nullOptional>=1 character
time_tickenumOptional
  • minute - minute
  • hour - hour
  • day - day

Response

modelstring
The model string from the URL path.
time_tickenum

Time-bucket size of the series (minute / hour / day).

  • minute - minute
  • hour - hour
  • day - day
start_timedatetime

Window start (UTC, inclusive).

end_timedatetime

Window end (UTC, exclusive).

datalist of objects

Per-provider uptime time series (per-attempt grain). Scoped to provider_id when that filter is supplied, else cross-provider.

provider_idstring or null

Echo of the provider_id filter, if one was supplied.

respan_uptimelist of objects

Request-grain ‘via Respan’ uptime time series: one verdict per client call, UP if ANY retry/fallback attempt succeeded. Reflects failover, so it sits at or above the per-provider data line. Same bucket shape as data. Omitted when a provider_id filter is supplied because the series is cross-provider.

metrics_serieslist of objects

Per-bucket performance metrics over the window (tps, ttft, latency, cache-hit %, + admin-only counts/cost) — the other metrics plotted over time like uptime. Scoped to provider_id when that filter is supplied, else cross-provider. Volume fields within are admin-only.

statusobject

Scalar model-wide status over the whole window (uptime %, throughput/latency, cache-hit %, catalog list price). Omitted when a provider_id filter is supplied (it is cross-provider). Volume fields within are admin-only.