> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Service API overview

> Use the Weave Service API, which provides REST endpoints for programmatic access to Weave functionality.

## Base URL

For [W\&B Multi-tenant Cloud](/platform/hosting/hosting-options/multi_tenant_cloud) and [W\&B Dedicated Cloud](/platform/hosting/hosting-options/dedicated-cloud), use the following base URL:

```
https://trace.wandb.ai
```

For [W\&B Self-Managed instances](/weave/guides/platform/weave-self-managed), use:

```
https://<your-subdomain>.wandb.io/traces
```

## Authentication

Include your W\&B API key in the request headers:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" https://trace.wandb.ai/...
```

## Available Endpoints

### Calls

* **[POST /call/end](https://docs.wandb.ai/weave/reference/service-api/calls/call-end)** - Call End
* **[POST /call/read](https://docs.wandb.ai/weave/reference/service-api/calls/call-read)** - Call Read
* **[POST /call/start](https://docs.wandb.ai/weave/reference/service-api/calls/call-start)** - Call Start
* **[POST /call/update](https://docs.wandb.ai/weave/reference/service-api/calls/call-update)** - Call Update
* **[POST /call/upsert\_batch](https://docs.wandb.ai/weave/reference/service-api/calls/call-start-batch)** - Call Start Batch
* **[POST /calls/delete](https://docs.wandb.ai/weave/reference/service-api/calls/calls-delete)** - Calls Delete
* **[POST /calls/query\_stats](https://docs.wandb.ai/weave/reference/service-api/calls/calls-query-stats)** - Calls Query Stats
* **[POST /calls/stats](https://docs.wandb.ai/weave/reference/service-api/calls/call-stats)** - Call Stats
* **[POST /calls/stream\_query](https://docs.wandb.ai/weave/reference/service-api/calls/calls-query-stream)** - Calls Query Stream
* **[POST /calls/usage](https://docs.wandb.ai/weave/reference/service-api/calls/calls-usage)** - Calls Usage
* **[POST /trace/usage](https://docs.wandb.ai/weave/reference/service-api/calls/trace-usage)** - Trace Usage

### Costs

* **[POST /cost/create](https://docs.wandb.ai/weave/reference/service-api/costs/cost-create)** - Cost Create
* **[POST /cost/purge](https://docs.wandb.ai/weave/reference/service-api/costs/cost-purge)** - Cost Purge
* **[POST /cost/query](https://docs.wandb.ai/weave/reference/service-api/costs/cost-query)** - Cost Query

### Feedback

* **[POST /feedback/batch/create](https://docs.wandb.ai/weave/reference/service-api/feedback/feedback-create-batch)** - Feedback Create Batch
* **[POST /feedback/create](https://docs.wandb.ai/weave/reference/service-api/feedback/feedback-create)** - Feedback Create
* **[POST /feedback/payload\_schema](https://docs.wandb.ai/weave/reference/service-api/feedback/feedback-payload-schema)** - Feedback Payload Schema
* **[POST /feedback/purge](https://docs.wandb.ai/weave/reference/service-api/feedback/feedback-purge)** - Feedback Purge
* **[POST /feedback/query](https://docs.wandb.ai/weave/reference/service-api/feedback/feedback-query)** - Feedback Query
* **[POST /feedback/replace](https://docs.wandb.ai/weave/reference/service-api/feedback/feedback-replace)** - Feedback Replace
* **[POST /feedback/stats](https://docs.wandb.ai/weave/reference/service-api/feedback/feedback-stats)** - Feedback Stats

### Files

* **[POST /file/content](https://docs.wandb.ai/weave/reference/service-api/files/file-content)** - File Content
* **[POST /file/create](https://docs.wandb.ai/weave/reference/service-api/files/file-create)** - File Create
* **[POST /files/query\_stats](https://docs.wandb.ai/weave/reference/service-api/files/files-stats)** - Files Stats

### Objects

* **[GET /aliases](https://docs.wandb.ai/weave/reference/service-api/objects/aliases-list)** - Aliases List
* **[POST /obj/create](https://docs.wandb.ai/weave/reference/service-api/objects/obj-create)** - Obj Create
* **[POST /obj/delete](https://docs.wandb.ai/weave/reference/service-api/objects/obj-delete)** - Obj Delete
* **[POST /obj/read](https://docs.wandb.ai/weave/reference/service-api/objects/obj-read)** - Obj Read
* **[POST /objs/query](https://docs.wandb.ai/weave/reference/service-api/objects/objs-query)** - Objs Query
* **[PUT /objs/{object_id}/aliases](https://docs.wandb.ai/weave/reference/service-api/objects/obj-set-aliases)** - Obj Set Aliases
* **[POST /objs/{object_id}/aliases/remove](https://docs.wandb.ai/weave/reference/service-api/objects/obj-remove-aliases)** - Obj Remove Aliases
* **[PUT /objs/{object_id}/versions/{digest}/tags](https://docs.wandb.ai/weave/reference/service-api/objects/obj-add-tags)** - Obj Add Tags
* **[POST /objs/{object_id}/versions/{digest}/tags/remove](https://docs.wandb.ai/weave/reference/service-api/objects/obj-remove-tags)** - Obj Remove Tags
* **[GET /tags](https://docs.wandb.ai/weave/reference/service-api/objects/tags-list)** - Tags List

### OpenTelemetry

* **[POST /otel/v1/traces](https://docs.wandb.ai/weave/reference/service-api/opentelemetry/export-trace)** - Export Trace

### Refs

* **[POST /refs/read\_batch](https://docs.wandb.ai/weave/reference/service-api/refs/refs-read-batch)** - Refs Read Batch

### Service

* **[GET /geolocate](https://docs.wandb.ai/weave/reference/service-api/service/get-caller-location)** - Get Caller Location
* **[GET /health](https://docs.wandb.ai/weave/reference/service-api/service/read-root)** - Read Root
* **[GET /server\_info](https://docs.wandb.ai/weave/reference/service-api/service/server-info)** - Server Info
* **[POST /service/projects\_info](https://docs.wandb.ai/weave/reference/service-api/service/projects-info)** - Projects Info
* **[GET /version](https://docs.wandb.ai/weave/reference/service-api/service/read-version)** - Read Version

### Tables

* **[POST /table/create](https://docs.wandb.ai/weave/reference/service-api/tables/table-create)** - Table Create
* **[POST /table/create\_from\_digests](https://docs.wandb.ai/weave/reference/service-api/tables/table-create-from-digests)** - Table Create From Digests
* **[POST /table/query](https://docs.wandb.ai/weave/reference/service-api/tables/table-query)** - Table Query
* **[POST /table/query\_stats](https://docs.wandb.ai/weave/reference/service-api/tables/table-query-stats)** - Table Query Stats
* **[POST /table/query\_stats\_batch](https://docs.wandb.ai/weave/reference/service-api/tables/table-query-stats-batch)** - Table Query Stats Batch
* **[POST /table/update](https://docs.wandb.ai/weave/reference/service-api/tables/table-update)** - Table Update
* **[POST /table/query\_stream](https://docs.wandb.ai/weave/reference/service-api/table-query-stream)** - Table Query Stream

### Threads

* **[POST /threads/stream\_query](https://docs.wandb.ai/weave/reference/service-api/threads/threads-query-stream)** - Threads Query Stream

### Inference

* **[GET /inference/analysis/artificialanalysis/models](https://docs.wandb.ai/weave/reference/service-api/inference/inference-analysis-artificialanalysis-models)** - Inference Analysis Artificialanalysis Models
* **[GET /inference/nvidia/v2/hardware](https://docs.wandb.ai/weave/reference/service-api/inference/nvidia-hardware)** - Nvidia Hardware
* **[GET /inference/router/openrouter/models](https://docs.wandb.ai/weave/reference/service-api/inference/inference-router-openrouter-models)** - Inference Router Openrouter Models

### Annotation Queues

* **[POST /annotation\_queues](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queue-create)** - Annotation Queue Create
* **[POST /annotation\_queues/query](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queues-query-stream)** - Annotation Queues Query Stream
* **[POST /annotation\_queues/stats](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queues-stats)** - Annotation Queues Stats
* **[DELETE /annotation\_queues/{queue_id}](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queue-delete)** - Annotation Queue Delete
* **[GET /annotation\_queues/{queue_id}](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queue-read)** - Annotation Queue Read
* **[PUT /annotation\_queues/{queue_id}](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queue-update)** - Annotation Queue Update
* **[POST /annotation\_queues/{queue_id}/items](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queue-add-calls)** - Annotation Queue Add Calls
* **[POST /annotation\_queues/{queue_id}/items/query](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queue-items-query)** - Annotation Queue Items Query
* **[POST /annotation\_queues/{queue_id}/items/{item_id}/progress](https://docs.wandb.ai/weave/reference/service-api/annotation-queues/annotation-queue-item-progress-update)** - Annotation Queue Item Progress Update

### Evaluations

* **[POST /evaluations/evaluate\_model](https://docs.wandb.ai/weave/reference/service-api/evaluations/evaluate-model)** - Evaluate Model
* **[POST /evaluations/status](https://docs.wandb.ai/weave/reference/service-api/evaluations/evaluation-status)** - Evaluation Status
* **[GET /v2/{entity}/{project}/evaluations](https://docs.wandb.ai/weave/reference/service-api/evaluations/evaluation-list)** - Evaluation List
* **[POST /v2/{entity}/{project}/evaluations](https://docs.wandb.ai/weave/reference/service-api/evaluations/evaluation-create)** - Evaluation Create
* **[DELETE /v2/{entity}/{project}/evaluations/{object_id}](https://docs.wandb.ai/weave/reference/service-api/evaluations/evaluation-delete)** - Evaluation Delete
* **[GET /v2/{entity}/{project}/evaluations/{object_id}/versions/{digest}](https://docs.wandb.ai/weave/reference/service-api/evaluations/evaluation-read)** - Evaluation Read

### Scores

* **[POST /calls/score](https://docs.wandb.ai/weave/reference/service-api/scores/calls-score)** - Calls Score
* **[DELETE /v2/{entity}/{project}/scores](https://docs.wandb.ai/weave/reference/service-api/scores/score-delete)** - Score Delete
* **[GET /v2/{entity}/{project}/scores](https://docs.wandb.ai/weave/reference/service-api/scores/score-list)** - Score List
* **[POST /v2/{entity}/{project}/scores](https://docs.wandb.ai/weave/reference/service-api/scores/score-create)** - Score Create
* **[GET /v2/{entity}/{project}/scores/{score_id}](https://docs.wandb.ai/weave/reference/service-api/scores/score-read)** - Score Read

### Images

* **[POST /image/create](https://docs.wandb.ai/weave/reference/service-api/images/image-create)** - Image Create

### Ops

* **[GET /v2/{entity}/{project}/ops](https://docs.wandb.ai/weave/reference/service-api/ops/op-list)** - Op List
* **[POST /v2/{entity}/{project}/ops](https://docs.wandb.ai/weave/reference/service-api/ops/op-create)** - Op Create
* **[DELETE /v2/{entity}/{project}/ops/{object_id}](https://docs.wandb.ai/weave/reference/service-api/ops/op-delete)** - Op Delete
* **[GET /v2/{entity}/{project}/ops/{object_id}/versions/{digest}](https://docs.wandb.ai/weave/reference/service-api/ops/op-read)** - Op Read

### Datasets

* **[GET /v2/{entity}/{project}/datasets](https://docs.wandb.ai/weave/reference/service-api/datasets/dataset-list)** - Dataset List
* **[POST /v2/{entity}/{project}/datasets](https://docs.wandb.ai/weave/reference/service-api/datasets/dataset-create)** - Dataset Create
* **[DELETE /v2/{entity}/{project}/datasets/{object_id}](https://docs.wandb.ai/weave/reference/service-api/datasets/dataset-delete)** - Dataset Delete
* **[GET /v2/{entity}/{project}/datasets/{object_id}/versions/{digest}](https://docs.wandb.ai/weave/reference/service-api/datasets/dataset-read)** - Dataset Read

### Scorers

* **[GET /v2/{entity}/{project}/scorers](https://docs.wandb.ai/weave/reference/service-api/scorers/scorer-list)** - Scorer List
* **[POST /v2/{entity}/{project}/scorers](https://docs.wandb.ai/weave/reference/service-api/scorers/scorer-create)** - Scorer Create
* **[DELETE /v2/{entity}/{project}/scorers/{object_id}](https://docs.wandb.ai/weave/reference/service-api/scorers/scorer-delete)** - Scorer Delete
* **[GET /v2/{entity}/{project}/scorers/{object_id}/versions/{digest}](https://docs.wandb.ai/weave/reference/service-api/scorers/scorer-read)** - Scorer Read

### Models

* **[GET /v2/{entity}/{project}/models](https://docs.wandb.ai/weave/reference/service-api/models/model-list)** - Model List
* **[POST /v2/{entity}/{project}/models](https://docs.wandb.ai/weave/reference/service-api/models/model-create)** - Model Create
* **[DELETE /v2/{entity}/{project}/models/{object_id}](https://docs.wandb.ai/weave/reference/service-api/models/model-delete)** - Model Delete
* **[GET /v2/{entity}/{project}/models/{object_id}/versions/{digest}](https://docs.wandb.ai/weave/reference/service-api/models/model-read)** - Model Read

### Evaluation Runs

* **[DELETE /v2/{entity}/{project}/evaluation\_runs](https://docs.wandb.ai/weave/reference/service-api/evaluation-runs/evaluation-run-delete)** - Evaluation Run Delete
* **[GET /v2/{entity}/{project}/evaluation\_runs](https://docs.wandb.ai/weave/reference/service-api/evaluation-runs/evaluation-run-list)** - Evaluation Run List
* **[POST /v2/{entity}/{project}/evaluation\_runs](https://docs.wandb.ai/weave/reference/service-api/evaluation-runs/evaluation-run-create)** - Evaluation Run Create
* **[GET /v2/{entity}/{project}/evaluation\_runs/{evaluation_run_id}](https://docs.wandb.ai/weave/reference/service-api/evaluation-runs/evaluation-run-read)** - Evaluation Run Read
* **[POST /v2/{entity}/{project}/evaluation\_runs/{evaluation_run_id}/finish](https://docs.wandb.ai/weave/reference/service-api/evaluation-runs/evaluation-run-finish)** - Evaluation Run Finish

### Predictions

* **[DELETE /v2/{entity}/{project}/predictions](https://docs.wandb.ai/weave/reference/service-api/predictions/prediction-delete)** - Prediction Delete
* **[GET /v2/{entity}/{project}/predictions](https://docs.wandb.ai/weave/reference/service-api/predictions/prediction-list)** - Prediction List
* **[POST /v2/{entity}/{project}/predictions](https://docs.wandb.ai/weave/reference/service-api/predictions/prediction-create)** - Prediction Create
* **[GET /v2/{entity}/{project}/predictions/{prediction_id}](https://docs.wandb.ai/weave/reference/service-api/predictions/prediction-read)** - Prediction Read
* **[POST /v2/{entity}/{project}/predictions/{prediction_id}/finish](https://docs.wandb.ai/weave/reference/service-api/predictions/prediction-finish)** - Prediction Finish

### Eval Results

* **[POST /v2/{entity}/{project}/eval\_results/query](https://docs.wandb.ai/weave/reference/service-api/eval-results/eval-results-query)** - Eval Results Query