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
• POST /v2/{entity}/{project}/calls/complete - Calls Complete

Costs

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

Feedback

• POST /feedback/aggregate - Feedback Aggregate
• 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/{object_id}/aliases - Obj Set Aliases
• POST /objs/{object_id}/aliases/remove - Obj Remove Aliases
• PUT /objs/{object_id}/versions/{digest}/tags - Obj Add Tags
• POST /objs/{object_id}/versions/{digest}/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/catalog/models - Inference Catalog Models
• GET /inference/modelsdev/models - Inference Modelsdev Models
• GET /inference/nvidia/v2/hardware - Nvidia Hardware
• GET /inference/router/openrouter/models - Inference Router Openrouter Models

Agents

• POST /agents/agent-versions/query - Genai Agent Versions Query
• POST /agents/conversations/chat - Genai Conversation Chat
• POST /agents/conversations/spans - Genai Conversation Spans
• POST /agents/otel/v1/traces - Export Genai Trace
• POST /agents/query - Genai Agents Query
• POST /agents/search - Genai Search
• POST /agents/spans/custom-attrs/schema - Genai Custom Attrs Schema
• POST /agents/spans/query - Genai Spans Query
• POST /agents/spans/stats - Genai Spans Stats
• POST /agents/traces/chat - Genai Traces Chat

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/{queue_id} - Annotation Queue Delete
• GET /annotation_queues/{queue_id} - Annotation Queue Read
• PUT /annotation_queues/{queue_id} - Annotation Queue Update
• POST /annotation_queues/{queue_id}/items - Annotation Queue Add Calls
• POST /annotation_queues/{queue_id}/items/query - Annotation Queue Items Query
• POST /annotation_queues/{queue_id}/items/{item_id}/progress - Annotation Queue Item Progress Update

Datasets

• GET /v2/{entity}/{project}/datasets - Dataset List
• POST /v2/{entity}/{project}/datasets - Dataset Create
• DELETE /v2/{entity}/{project}/datasets/{object_id} - Dataset Delete
• GET /v2/{entity}/{project}/datasets/{object_id}/versions/{digest} - Dataset Read

Eval Results

• POST /v2/{entity}/{project}/eval_results/query - Eval Results Query

Evaluation Runs

• DELETE /v2/{entity}/{project}/evaluation_runs - Evaluation Run Delete
• GET /v2/{entity}/{project}/evaluation_runs - Evaluation Run List
• POST /v2/{entity}/{project}/evaluation_runs - Evaluation Run Create
• GET /v2/{entity}/{project}/evaluation_runs/{evaluation_run_id} - Evaluation Run Read
• POST /v2/{entity}/{project}/evaluation_runs/{evaluation_run_id}/finish - Evaluation Run Finish

Evaluations

• POST /evaluations/evaluate_model - Evaluate Model
• POST /evaluations/rescore - Rescore Evaluation
• POST /evaluations/status - Evaluation Status
• GET /v2/{entity}/{project}/evaluations - Evaluation List
• POST /v2/{entity}/{project}/evaluations - Evaluation Create
• DELETE /v2/{entity}/{project}/evaluations/{object_id} - Evaluation Delete
• GET /v2/{entity}/{project}/evaluations/{object_id}/versions/{digest} - Evaluation Read

Images

• POST /image/create - Image Create

Models

• GET /v2/{entity}/{project}/models - Model List
• POST /v2/{entity}/{project}/models - Model Create
• DELETE /v2/{entity}/{project}/models/{object_id} - Model Delete
• GET /v2/{entity}/{project}/models/{object_id}/versions/{digest} - Model Read

Ops

• GET /v2/{entity}/{project}/ops - Op List
• POST /v2/{entity}/{project}/ops - Op Create
• DELETE /v2/{entity}/{project}/ops/{object_id} - Op Delete
• GET /v2/{entity}/{project}/ops/{object_id}/versions/{digest} - Op Read

Predictions

• DELETE /v2/{entity}/{project}/predictions - Prediction Delete
• GET /v2/{entity}/{project}/predictions - Prediction List
• POST /v2/{entity}/{project}/predictions - Prediction Create
• GET /v2/{entity}/{project}/predictions/{prediction_id} - Prediction Read
• POST /v2/{entity}/{project}/predictions/{prediction_id}/finish - Prediction Finish

Registry

• POST /link_to_registry - Link To Registry

Scorers

• GET /v2/{entity}/{project}/scorers - Scorer List
• POST /v2/{entity}/{project}/scorers - Scorer Create
• DELETE /v2/{entity}/{project}/scorers/{object_id} - Scorer Delete
• GET /v2/{entity}/{project}/scorers/{object_id}/versions/{digest} - Scorer Read

Scores

• POST /calls/score - Calls Score
• DELETE /v2/{entity}/{project}/scores - Score Delete
• GET /v2/{entity}/{project}/scores - Score List
• POST /v2/{entity}/{project}/scores - Score Create
• GET /v2/{entity}/{project}/scores/{score_id} - Score Read