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 and W&B Dedicated Cloud, use the following base URL:

https://trace.wandb.ai

For W&B Self-Managed instances, use:

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

Authentication

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

curl -H "Authorization: Bearer YOUR_API_KEY" https://trace.wandb.ai/...

Available Endpoints

Calls

• POST /call/end - Call End
• POST /call/read - Call Read
• POST /call/start - Call Start
• POST /call/update - Call Update
• POST /call/upsert_batch - Call Start Batch
• POST /calls/delete - Calls Delete
• POST /calls/query_stats - Calls Query Stats
• POST /calls/stats - Call Stats
• POST /calls/stream_query - Calls Query Stream
• POST /calls/usage - Calls Usage
• POST /trace/usage - Trace Usage

Costs

• POST /cost/create - Cost Create
• POST /cost/purge - Cost Purge
• POST /cost/query - Cost Query

Feedback

• POST /feedback/batch/create - Feedback Create Batch
• POST /feedback/create - Feedback Create
• POST /feedback/payload_schema - Feedback Payload Schema
• POST /feedback/purge - Feedback Purge
• POST /feedback/query - Feedback Query
• POST /feedback/replace - Feedback Replace
• POST /feedback/stats - Feedback Stats

Files

• POST /file/content - File Content
• POST /file/create - File Create
• POST /files/query_stats - Files Stats

Objects

• GET /aliases - Aliases List
• POST /obj/create - Obj Create
• POST /obj/delete - Obj Delete
• POST /obj/read - Obj Read
• POST /objs/query - Objs Query
• PUT /objs//aliases - Obj Set Aliases
• POST /objs//aliases/remove - Obj Remove Aliases
• PUT /objs//versions//tags - Obj Add Tags
• POST /objs//versions//tags/remove - Obj Remove Tags
• GET /tags - Tags List

OpenTelemetry

• POST /otel/v1/traces - Export Trace

Refs

• POST /refs/read_batch - Refs Read Batch

Service

• GET /geolocate - Get Caller Location
• GET /health - Read Root
• GET /server_info - Server Info
• POST /service/projects_info - Projects Info
• GET /version - Read Version

Tables

• POST /table/create - Table Create
• POST /table/create_from_digests - Table Create From Digests
• POST /table/query - Table Query
• POST /table/query_stats - Table Query Stats
• POST /table/query_stats_batch - Table Query Stats Batch
• POST /table/update - Table Update

Threads

• POST /threads/stream_query - Threads Query Stream

Inference

• GET /inference/analysis/artificialanalysis/models - Inference Analysis Artificialanalysis Models
• GET /inference/nvidia/v2/hardware - Nvidia Hardware
• GET /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-queues) - Annotation Queue Create
• [POST /annotation_queues/query](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queues-query-stream-annotation-queues-query) - Annotation Queues Query Stream
• [POST /annotation_queues/stats](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queues-stats-annotation-queues-stats) - Annotation Queues Stats
• [DELETE /annotation_queues/](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queue-delete-annotation-queues—queue-id-) - Annotation Queue Delete
• [GET /annotation_queues/](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queue-read-annotation-queues—queue-id-) - Annotation Queue Read
• [PUT /annotation_queues/](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queue-update-annotation-queues—queue-id-) - Annotation Queue Update
• [POST /annotation_queues//items](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queue-add-calls-annotation-queues—queue-id—items) - Annotation Queue Add Calls
• [POST /annotation_queues//items/query](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queue-items-query-annotation-queues—queue-id—items-query) - Annotation Queue Items Query
• [POST /annotation_queues//items//progress](https://docs.wandb.ai/weave/reference/service-api/annotation queues/annotation-queue-item-progress-update-annotation-queues—queue-id—items—item-id—progress) - Annotation Queue Item Progress Update

Evaluations

• POST /evaluations/evaluate_model - Evaluate Model
• POST /evaluations/status - Evaluation Status
• GET /v2///evaluations - Evaluation List
• POST /v2///evaluations - Evaluation Create
• DELETE /v2///evaluations/ - Evaluation Delete
• GET /v2///evaluations//versions/ - Evaluation Read

Scores

• POST /calls/score - Calls Score
• DELETE /v2///scores - Score Delete
• GET /v2///scores - Score List
• POST /v2///scores - Score Create
• GET /v2///scores/ - Score Read

Images

• POST /image/create - Image Create

Registry

• POST /link_to_registry - Link To Registry

Ops

• GET /v2///ops - Op List
• POST /v2///ops - Op Create
• DELETE /v2///ops/ - Op Delete
• GET /v2///ops//versions/ - Op Read

Datasets

• GET /v2///datasets - Dataset List
• POST /v2///datasets - Dataset Create
• DELETE /v2///datasets/ - Dataset Delete
• GET /v2///datasets//versions/ - Dataset Read

Scorers

• GET /v2///scorers - Scorer List
• POST /v2///scorers - Scorer Create
• DELETE /v2///scorers/ - Scorer Delete
• GET /v2///scorers//versions/ - Scorer Read

Models

• GET /v2///models - Model List
• POST /v2///models - Model Create
• DELETE /v2///models/ - Model Delete
• GET /v2///models//versions/ - Model Read

Evaluation Runs

• [DELETE /v2///evaluation_runs](https://docs.wandb.ai/weave/reference/service-api/evaluation runs/evaluation-run-delete-v2—entity---project—evaluation-runs) - Evaluation Run Delete
• [GET /v2///evaluation_runs](https://docs.wandb.ai/weave/reference/service-api/evaluation runs/evaluation-run-list-v2—entity---project—evaluation-runs) - Evaluation Run List
• [POST /v2///evaluation_runs](https://docs.wandb.ai/weave/reference/service-api/evaluation runs/evaluation-run-create-v2—entity---project—evaluation-runs) - Evaluation Run Create
• [GET /v2///evaluation_runs/](https://docs.wandb.ai/weave/reference/service-api/evaluation runs/evaluation-run-read-v2—entity---project—evaluation-runs—evaluation-run-id-) - Evaluation Run Read
• [POST /v2///evaluation_runs//finish](https://docs.wandb.ai/weave/reference/service-api/evaluation runs/evaluation-run-finish-v2—entity---project—evaluation-runs—evaluation-run-id—finish) - Evaluation Run Finish

Predictions

• DELETE /v2///predictions - Prediction Delete
• GET /v2///predictions - Prediction List
• POST /v2///predictions - Prediction Create
• GET /v2///predictions/ - Prediction Read
• POST /v2///predictions//finish - Prediction Finish

Eval Results

• [POST /v2///eval_results/query](https://docs.wandb.ai/weave/reference/service-api/eval results/eval-results-query-v2—entity---project—eval-results-query) - Eval Results Query

Calls

• POST /call/end - Call End
• POST /call/read - Call Read
• POST /call/start - Call Start
• POST /call/update - Call Update
• POST /call/upsert_batch - Call Start Batch
• POST /calls/delete - Calls Delete
• POST /calls/query_stats - Calls Query Stats
• POST /calls/stats - Call Stats
• POST /calls/stream_query - Calls Query Stream
• POST /calls/usage - Calls Usage
• POST /trace/usage - Trace Usage

Costs

• POST /cost/create - Cost Create
• POST /cost/purge - Cost Purge
• POST /cost/query - Cost Query

Feedback

• POST /feedback/batch/create - Feedback Create Batch
• POST /feedback/create - Feedback Create
• POST /feedback/payload_schema - Feedback Payload Schema
• POST /feedback/purge - Feedback Purge
• POST /feedback/query - Feedback Query
• POST /feedback/replace - Feedback Replace
• POST /feedback/stats - Feedback Stats

Files

• POST /file/content - File Content
• POST /file/create - File Create
• POST /files/query_stats - Files Stats

Objects

• GET /aliases - Aliases List
• POST /obj/create - Obj Create
• POST /obj/delete - Obj Delete
• POST /obj/read - Obj Read
• POST /objs/query - Objs Query
• PUT /objs//aliases - Obj Set Aliases
• POST /objs//aliases/remove - Obj Remove Aliases
• PUT /objs//versions//tags - Obj Add Tags
• POST /objs//versions//tags/remove - Obj Remove Tags
• GET /tags - Tags List

OpenTelemetry

• POST /otel/v1/traces - Export Trace

Refs

• POST /refs/read_batch - Refs Read Batch

Service

• GET /geolocate - Get Caller Location
• GET /health - Read Root
• GET /server_info - Server Info
• POST /service/projects_info - Projects Info
• GET /version - Read Version

Tables

• POST /table/create - Table Create
• POST /table/create_from_digests - Table Create From Digests
• POST /table/query - Table Query
• POST /table/query_stats - Table Query Stats
• POST /table/query_stats_batch - Table Query Stats Batch
• POST /table/update - Table Update
• POST /table/query_stream - Table Query Stream

Threads

• POST /threads/stream_query - Threads Query Stream

Inference

• GET /inference/analysis/artificialanalysis/models - Inference Analysis Artificialanalysis Models
• GET /inference/nvidia/v2/hardware - Nvidia Hardware
• GET /inference/router/openrouter/models - Inference Router Openrouter Models

Annotation Queues

• POST /annotation_queues - Annotation Queue Create
• POST /annotation_queues/query - Annotation Queues Query Stream
• POST /annotation_queues/stats - Annotation Queues Stats
• DELETE /annotation_queues/ - Annotation Queue Delete
• GET /annotation_queues/ - Annotation Queue Read
• PUT /annotation_queues/ - Annotation Queue Update
• POST /annotation_queues//items - Annotation Queue Add Calls
• POST /annotation_queues//items/query - Annotation Queue Items Query
• POST /annotation_queues//items//progress - Annotation Queue Item Progress Update

Evaluations

• POST /evaluations/evaluate_model - Evaluate Model
• POST /evaluations/status - Evaluation Status
• GET /v2///evaluations - Evaluation List
• POST /v2///evaluations - Evaluation Create
• DELETE /v2///evaluations/ - Evaluation Delete
• GET /v2///evaluations//versions/ - Evaluation Read

Scores

• POST /calls/score - Calls Score
• DELETE /v2///scores - Score Delete
• GET /v2///scores - Score List
• POST /v2///scores - Score Create
• GET /v2///scores/ - Score Read

Images

• POST /image/create - Image Create

Ops

• GET /v2///ops - Op List
• POST /v2///ops - Op Create
• DELETE /v2///ops/ - Op Delete
• GET /v2///ops//versions/ - Op Read

Datasets

• GET /v2///datasets - Dataset List
• POST /v2///datasets - Dataset Create
• DELETE /v2///datasets/ - Dataset Delete
• GET /v2///datasets//versions/ - Dataset Read

Scorers

• GET /v2///scorers - Scorer List
• POST /v2///scorers - Scorer Create
• DELETE /v2///scorers/ - Scorer Delete
• GET /v2///scorers//versions/ - Scorer Read

Models

• GET /v2///models - Model List
• POST /v2///models - Model Create
• DELETE /v2///models/ - Model Delete
• GET /v2///models//versions/ - Model Read

Evaluation Runs

• DELETE /v2///evaluation_runs - Evaluation Run Delete
• GET /v2///evaluation_runs - Evaluation Run List
• POST /v2///evaluation_runs - Evaluation Run Create
• GET /v2///evaluation_runs/ - Evaluation Run Read
• POST /v2///evaluation_runs//finish - Evaluation Run Finish

Predictions

• DELETE /v2///predictions - Prediction Delete
• GET /v2///predictions - Prediction List
• POST /v2///predictions - Prediction Create
• GET /v2///predictions/ - Prediction Read
• POST /v2///predictions//finish - Prediction Finish

Eval Results

• POST /v2///eval_results/query - Eval Results Query