Skip to main content
GET
cURL
This endpoint is in beta. The request and response structure may change before it’s generally available. Startup metrics require access for your organization. Contact support to request access.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Path Parameters

model_id
string
required
deployment_id
string
required

Query Parameters

start_epoch_millis
integer
required

Start of the query window, in epoch milliseconds.

end_epoch_millis
integer
required

End of the query window, in epoch milliseconds. Must be after the start.

min_duration_ms
integer | null

Only include startups that lasted at least this many milliseconds.

Required range: x >= 0
cursor
string | null

Opaque cursor returned by a previous page. Omit to fetch the first page. Pass the same filters and sort as the request that returned it.

limit
integer
default:50

Maximum number of attempts to return.

Required range: 1 <= x <= 100
outcomes
enum<string>[]

Only include attempts with one of these outcomes. Repeat to pass several.

Outcome of a whole startup attempt.

Available options:
SUCCESS,
FAILED,
STALLED
phase
enum<string> | null

Only include attempts that spent longer than 0 ms in this phase. A stage of a replica startup.

  • SCHEDULING: waiting for the replica to be placed on a node.
  • IMAGE_PULL: pulling the container image.
  • WEIGHT_DOWNLOAD: downloading model weights.
  • CONTAINER_CREATE: creating and starting the model container, including CONTAINER_START and READINESS.
  • CONTAINER_START: starting the model container.
  • READINESS: waiting for the model to pass its readiness check.

CONTAINER_START and READINESS are accepted as filters but are reported only as part of CONTAINER_CREATE.

Available options:
SCHEDULING,
IMAGE_PULL,
WEIGHT_DOWNLOAD,
CONTAINER_CREATE,
CONTAINER_START,
READINESS
search
string | null

Only include attempts whose replica ID matches exactly, or whose deployment name contains this text (case-insensitive).

sort_by
enum<string> | null

Field to sort attempts by. Defaults to STARTED_AT. Field to sort startup attempts by.

Available options:
OUTCOME,
STARTED_AT,
READY_AT,
DURATION
direction
enum<string> | null

Sort direction. Defaults to desc.

Available options:
asc,
desc

Response

200 - application/json

A page of startup attempts, newest first by default.

items
StartupAttemptV1 · object[]
required

Items in this page.

pagination
PaginationResponseV1 · object
required

Pagination metadata for the page.

total_count
integer
required

Number of attempts matching the filters, counted within the 1,000 most recent startups in the window.