Inference
Endpoints
Every inference route at a glance.
All routes require Authorization and X-Workspace-Id headers.
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/inference/goals/{goal_id}/infer | Raw inference via goal alias — survives champion swaps + promotions |
| POST | /v1/inference/goals/{goal_id}/infer-segment | Segment inference via goal alias |
| POST | /v1/inference/pipelines/{pipeline_id}/infer | Raw inference via pipeline alias — survives promotions |
| POST | /v1/inference/pipelines/{pipeline_id}/infer-segment | Segment inference via pipeline alias |
| POST | /v1/inference/deployments/{deployment_id}/infer | Raw inference, version-pinned |
| POST | /v1/inference/deployments/{deployment_id}/infer-segment | Segment inference, version-pinned |
| GET | /v1/inference | List past inferences (paginated, filterable) |
| GET | /v1/inference/{inference_id} | Inspect one inference — full record + history window |
| GET | /v1/inference/deployments/{deployment_id}/usage | Deployment usage over time |