Service API overview

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

Base URL

https://trace.wandb.ai

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/stream_query - Calls Query Stream

Costs

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

Feedback

• POST /feedback/create - Feedback Create
• POST /feedback/purge - Feedback Purge
• POST /feedback/query - Feedback Query
• POST /feedback/replace - Feedback Replace

Files

• POST /file/content - File Content
• POST /file/create - File Create

Objects

• POST /obj/create - Obj Create
• POST /obj/delete - Obj Delete
• POST /obj/read - Obj Read
• POST /objs/query - Objs Query

OpenTelemetry

• POST /otel/v1/trace - Export Trace

Refs

• POST /refs/read_batch - Refs Read Batch

Service

• GET /health - Read Root
• GET /server_info - Server Info

Tables

• POST /table/create - Table Create
• POST /table/query - Table Query
• POST /table/query_stats - Table Query Stats
• POST /table/update - Table Update

Threads

• POST /threads/stream_query - Threads Query Stream

Uncategorized

• POST /table/query_stream - Table Query Stream

Completions

• POST /completions/create - Completions Create
• POST /completions/create_stream - Completions Create Stream

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

Evaluations

• GET /v2///evaluations - Evaluation List
• POST /v2///evaluations - Evaluation Create
• DELETE /v2///evaluations/ - Evaluation Delete
• GET /v2///evaluations//versions/ - Evaluation Read

Evaluation Runs

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

Models

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

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

Scores

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

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/stream_query - Calls Query Stream

Costs

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

Feedback

• POST /feedback/create - Feedback Create
• POST /feedback/purge - Feedback Purge
• POST /feedback/query - Feedback Query
• POST /feedback/replace - Feedback Replace

Files

• POST /file/content - File Content
• POST /file/create - File Create

Objects

• POST /obj/create - Obj Create
• POST /obj/delete - Obj Delete
• POST /obj/read - Obj Read
• POST /objs/query - Objs Query

OpenTelemetry

• POST /otel/v1/trace - Export Trace

Refs

• POST /refs/read_batch - Refs Read Batch

Service

• GET /health - Read Root
• GET /server_info - Server Info

Tables

• POST /table/create - Table Create
• POST /table/query - Table Query
• POST /table/query_stats - Table Query Stats
• POST /table/update - Table Update

Threads

• POST /threads/stream_query - Threads Query Stream

Uncategorized

• POST /table/query_stream - Table Query Stream

Completions

• POST /completions/create - Completions Create
• POST /completions/create_stream - Completions Create Stream

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

Evaluations

• GET /v2///evaluations - Evaluation List
• POST /v2///evaluations - Evaluation Create
• DELETE /v2///evaluations/ - Evaluation Delete
• GET /v2///evaluations//versions/ - Evaluation Read

Evaluation Runs

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

Models

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

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

Scores

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

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/stream_query - Calls Query Stream

Costs

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

Feedback

• POST /feedback/create - Feedback Create
• POST /feedback/purge - Feedback Purge
• POST /feedback/query - Feedback Query
• POST /feedback/replace - Feedback Replace

Files

• POST /file/content - File Content
• POST /file/create - File Create

Objects

• POST /obj/create - Obj Create
• POST /obj/delete - Obj Delete
• POST /obj/read - Obj Read
• POST /objs/query - Objs Query

OpenTelemetry

• POST /otel/v1/trace - Export Trace

Refs

• POST /refs/read_batch - Refs Read Batch

Service

• GET /health - Read Root
• GET /server_info - Server Info

Tables

• POST /table/create - Table Create
• POST /table/query - Table Query
• POST /table/query_stats - Table Query Stats
• POST /table/update - Table Update

Threads

• POST /threads/stream_query - Threads Query Stream

Uncategorized

• POST /table/query_stream - Table Query Stream

Completions

• POST /completions/create - Completions Create
• POST /completions/create_stream - Completions Create Stream

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

Evaluations

• GET /v2///evaluations - Evaluation List
• POST /v2///evaluations - Evaluation Create
• DELETE /v2///evaluations/ - Evaluation Delete
• GET /v2///evaluations//versions/ - Evaluation Read

Evaluation Runs

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

Models

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

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

Scores

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

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/stream_query - Calls Query Stream

Costs

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

Feedback

• POST /feedback/create - Feedback Create
• POST /feedback/purge - Feedback Purge
• POST /feedback/query - Feedback Query
• POST /feedback/replace - Feedback Replace

Files

• POST /file/content - File Content
• POST /file/create - File Create

Objects

• POST /obj/create - Obj Create
• POST /obj/delete - Obj Delete
• POST /obj/read - Obj Read
• POST /objs/query - Objs Query

OpenTelemetry

• POST /otel/v1/trace - Export Trace

Refs

• POST /refs/read_batch - Refs Read Batch

Service

• GET /health - Read Root
• GET /server_info - Server Info

Tables

• POST /table/create - Table Create
• POST /table/query - Table Query
• POST /table/query_stats - Table Query Stats
• POST /table/update - Table Update

Threads

• POST /threads/stream_query - Threads Query Stream

Uncategorized

• POST /table/query_stream - Table Query Stream

Completions

• POST /completions/create - Completions Create
• POST /completions/create_stream - Completions Create Stream

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

Evaluations

• GET /v2///evaluations - Evaluation List
• POST /v2///evaluations - Evaluation Create
• DELETE /v2///evaluations/ - Evaluation Delete
• GET /v2///evaluations//versions/ - Evaluation Read

Evaluation Runs

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

Models

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

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

Scores

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

Calls

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

Costs

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

Feedback

• POST /feedback/create - Feedback Create
• POST /feedback/query - Feedback Query
• POST /feedback/purge - Feedback Purge
• POST /feedback/replace - Feedback Replace

Files

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

Objects

• POST /obj/create - Obj Create
• POST /obj/read - Obj Read
• POST /obj/delete - Obj Delete

OpenTelemetry

• POST /otel/v1/traces - Export Trace

Refs

• POST /refs/read_batch - Refs Read Batch

Service

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

Tables

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

Threads

• POST /threads/stream_query - Threads Query Stream