> ## 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

### Registry

* **[POST /link\_to\_registry](https://docs.wandb.ai/weave/reference/service-api/registry/link-to-registry)** - Link To Registry

### 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