Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

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

Query Parameters

model
string | null

Restrict the response to one model, identified by its HuggingFace repo id. A supported model comes back with its 'enabled' flag and, when false, its 'enablement_details'. Without 'enabled', an empty list means Baseten does not support that model. Omit to list every supported model.

Example:

"Qwen/Qwen3-8B"

use_case
enum<string>
default:rl

What the caller intends to run. Defaults to 'rl', the stricter of the two: an RL run needs both a trainer and a sampler, so anything enabled for 'rl' is also enabled for 'sft'. What the caller intends to run.

Reinforcement learning runs a trainer and a sampler; supervised fine-tuning runs a trainer alone. A model can therefore be enabled for one and not the other, and the same model can support a longer sequence length for SFT than for RL.

Available options:
rl,
sft
Example:

"rl"

max_seq_len
integer | null

The sequence length the caller intends to train at — the same value they would pass as 'max_seq_len' when creating the run. Models that cannot serve it are reported as not enabled rather than returned with a ceiling the caller cannot use. Omit for the model's highest enabled sequence length.

Required range: x >= 1
Example:

32768

enabled
boolean | null

Pass true to list only the models this workspace can run now, or false for only the ones it cannot. Omit to list both. With 'model', an empty list can also mean the model is supported but filtered out.

Example:

true

Response

200 - application/json

Response for GET /v1/loops/capabilities.

A model Baseten does not support has no entry at all, so an empty list for a single-model request without enabled means exactly that.

supported_models
SupportedModelV1 · object[]
required

Models Baseten supports for this use case, each carrying an 'enabled' flag saying whether this workspace can run it now, and 'enablement_details' when it cannot. Models this workspace can run come first, then the rest, each group sorted by name.