Loops API reference

Use the Loops API to manage sessions, runs, samplers, checkpoints, and deployments over HTTP. Every request requires BASETEN_API_KEY. Most routes use /v1/loops and run in your organization’s default team. Routes under /v1/teams/{team_id}/loops provision or list resources in a specified team. The Loops Python SDK calls these routes when you pass a team_id. Pass your key in the Authorization: Bearer $BASETEN_API_KEY header. Each endpoint page documents its request body, query parameters, response shape, and interactive playground.

​

Resource model

A session owns runs and samplers. A run owns checkpoints, and checkpoints produce deployments. Both the HTTP API and the Python SDK identify a trainer by its run_id.

​

Endpoints

​

Sessions

​

Runs and trainers

​

Samplers

​

Checkpoints

​

Deployments

​

Server