trace_server_interface

Python SDK reference for weave.trace_server.trace_server_interface

API Overview

---

Source

class ActionsExecuteBatchReq

Pydantic Fields:

• project_id: <class 'str'>
• action_ref: <class 'str'>
• call_ids: list[str]
• wb_user_id: str | None

---

Source

class ActionsExecuteBatchRes

---

Source

class AnnotationQueueAddCallsReq

Request to add calls to an annotation queue in batch.

Extends AnnotationQueueAddCallsBody by adding queue_id for internal API usage.

Pydantic Fields:

• project_id: <class 'str'>
• call_ids: list[str]
• display_fields: list[str]
• queue_id: <class 'str'>
• wb_user_id: str | None

---

Source

class AnnotationQueueAddCallsRes

Response from adding calls to a queue.

Pydantic Fields:

• added_count: <class 'int'>
• duplicates: <class 'int'>

---

Source

class AnnotationQueueCreateReq

Request to create a new annotation queue.

Pydantic Fields:

• project_id: <class 'str'>
• name: <class 'str'>
• description: <class 'str'>
• scorer_refs: list[str]
• wb_user_id: str | None

---

Source

class AnnotationQueueCreateRes

Response from creating an annotation queue.

Pydantic Fields:

• id: <class 'str'>

---

Source

class AnnotationQueueItemSchema

Schema for annotation queue item responses.

Pydantic Fields:

• id: <class 'str'>
• project_id: <class 'str'>
• queue_id: <class 'str'>
• call_id: <class 'str'>
• call_started_at: <class 'datetime.datetime'>
• call_ended_at: datetime.datetime | None
• call_op_name: <class 'str'>
• call_trace_id: <class 'str'>
• display_fields: list[str]
• added_by: str | None
• annotation_state: typing.Literal['unstarted', 'in_progress', 'completed', 'skipped']
• annotator_user_id: str | None
• created_at: <class 'datetime.datetime'>
• created_by: <class 'str'>
• updated_at: <class 'datetime.datetime'>
• deleted_at: datetime.datetime | None
• position_in_queue: int | None

---

Source

class AnnotationQueueItemsQueryReq

Request to query items in an annotation queue.

Extends AnnotationQueueItemsQueryBody by adding queue_id for internal API usage.

Pydantic Fields:

• project_id: <class 'str'>
• filter: weave.trace_server.common_interface.AnnotationQueueItemsFilter | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None
• limit: int | None
• offset: int | None
• include_position: <class 'bool'>
• queue_id: <class 'str'>

---

Source

class AnnotationQueueItemsQueryRes

Response from querying annotation queue items.

Pydantic Fields:

• items: list[AnnotationQueueItemSchema]

---

Source

class AnnotationQueueReadReq

Request to read a specific annotation queue.

Pydantic Fields:

• project_id: <class 'str'>
• queue_id: <class 'str'>

---

Source

class AnnotationQueueReadRes

Response from reading an annotation queue.

Pydantic Fields:

• queue: <class 'AnnotationQueueSchema'>

---

Source

class AnnotationQueueSchema

Schema for annotation queue responses.

Pydantic Fields:

• id: <class 'str'>
• project_id: <class 'str'>
• name: <class 'str'>
• description: <class 'str'>
• scorer_refs: list[str]
• created_at: <class 'datetime.datetime'>
• created_by: <class 'str'>
• updated_at: <class 'datetime.datetime'>
• deleted_at: datetime.datetime | None

---

Source

class AnnotationQueueStatsSchema

Statistics for a single annotation queue.

Pydantic Fields:

• queue_id: <class 'str'>
• total_items: <class 'int'>
• completed_items: <class 'int'>

---

Source

class AnnotationQueuesQueryReq

Request to query annotation queues for a project.

Pydantic Fields:

• project_id: <class 'str'>
• name: str | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None
• limit: int | None
• offset: int | None

---

Source

class AnnotationQueuesQueryRes

Response from querying annotation queues.

Pydantic Fields:

• queues: list[AnnotationQueueSchema]

---

Source

class AnnotationQueuesStatsReq

Request to get stats for multiple annotation queues.

Pydantic Fields:

• project_id: <class 'str'>
• queue_ids: list[str]

---

Source

class AnnotationQueuesStatsRes

Response with stats for multiple annotation queues.

Pydantic Fields:

• stats: list[AnnotationQueueStatsSchema]

---

Source

class AnnotatorQueueItemsProgressUpdateReq

Request to update the annotation state of a queue item for the current annotator.

Valid state transitions:

• (absence) -> ‘in_progress’: Mark item as in progress (only when no record exists)
• (absence) -> ‘completed’ or ‘skipped’: Directly complete/skip item
• ‘in_progress’ or ‘unstarted’ -> ‘completed’ or ‘skipped’: Complete/skip started item

Pydantic Fields:

• project_id: <class 'str'>
• queue_id: <class 'str'>
• item_id: <class 'str'>
• annotation_state: <class 'str'>
• wb_user_id: str | None

---

Source

class AnnotatorQueueItemsProgressUpdateRes

Response from updating annotation state.

Pydantic Fields:

• item: <class 'AnnotationQueueItemSchema'>

---

Source

class CallBatchEndMode

Pydantic Fields:

• mode: <class 'str'>
• req: <class 'CallEndReq'>

---

Source

class CallBatchStartMode

Pydantic Fields:

• mode: <class 'str'>
• req: <class 'CallStartReq'>

---

Source

class CallCreateBatchReq

Pydantic Fields:

• batch: list[CallBatchStartMode | CallBatchEndMode]

---

Source

class CallCreateBatchRes

Pydantic Fields:

• res: list[CallStartRes | CallEndRes]

---

Source

class CallEndReq

Pydantic Fields:

• end: <class 'EndedCallSchemaForInsert'>

---

Source

class CallEndRes

---

Source

class CallReadReq

Pydantic Fields:

• project_id: <class 'str'>
• id: <class 'str'>
• include_costs: bool | None
• include_storage_size: bool | None
• include_total_storage_size: bool | None

---

Source

class CallReadRes

Pydantic Fields:

• call: CallSchema | None

---

Source

class CallSchema

Pydantic Fields:

• id: <class 'str'>
• project_id: <class 'str'>
• op_name: <class 'str'>
• display_name: str | None
• trace_id: <class 'str'>
• parent_id: str | None
• thread_id: str | None
• turn_id: str | None
• started_at: <class 'datetime.datetime'>
• attributes: dict[str, typing.Any]
• inputs: dict[str, typing.Any]
• ended_at: datetime.datetime | None
• exception: str | None
• output: typing.Any | None
• summary: SummaryMap | None
• wb_user_id: str | None
• wb_run_id: str | None
• wb_run_step: int | None
• wb_run_step_end: int | None
• deleted_at: datetime.datetime | None
• storage_size_bytes: int | None
• total_storage_size_bytes: int | None

Source

method serialize_typed_dicts

serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any]

---

Source

class CallStartReq

Pydantic Fields:

• start: <class 'StartedCallSchemaForInsert'>

---

Source

class CallStartRes

Pydantic Fields:

• id: <class 'str'>
• trace_id: <class 'str'>

---

Source

class CallUpdateReq

Pydantic Fields:

• project_id: <class 'str'>
• call_id: <class 'str'>
• display_name: str | None
• wb_user_id: str | None

---

Source

class CallUpdateRes

---

Source

class CallsDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• call_ids: list[str]
• wb_user_id: str | None

---

Source

class CallsDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class CallsFilter

Pydantic Fields:

• op_names: list[str] | None
• input_refs: list[str] | None
• output_refs: list[str] | None
• parent_ids: list[str] | None
• trace_ids: list[str] | None
• call_ids: list[str] | None
• thread_ids: list[str] | None
• turn_ids: list[str] | None
• trace_roots_only: bool | None
• wb_user_ids: list[str] | None
• wb_run_ids: list[str] | None

---

Source

class CallsQueryReq

Pydantic Fields:

• project_id: <class 'str'>
• filter: CallsFilter | None
• limit: int | None
• offset: int | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None
• query: weave.trace_server.interface.query.Query | None
• include_costs: bool | None
• include_feedback: bool | None
• include_storage_size: bool | None
• include_total_storage_size: bool | None
• columns: list[str] | None
• expand_columns: list[str] | None
• return_expanded_column_values: bool | None

---

Source

class CallsQueryRes

Pydantic Fields:

• calls: list[CallSchema]

---

Source

class CallsQueryStatsReq

Pydantic Fields:

• project_id: <class 'str'>
• filter: CallsFilter | None
• query: weave.trace_server.interface.query.Query | None
• limit: int | None
• include_total_storage_size: bool | None
• expand_columns: list[str] | None

---

Source

class CallsQueryStatsRes

Pydantic Fields:

• count: <class 'int'>
• total_storage_size_bytes: int | None

---

Source

class CompletionsCreateReq

Pydantic Fields:

• project_id: <class 'str'>
• inputs: <class 'CompletionsCreateRequestInputs'>
• wb_user_id: str | None
• track_llm_call: bool | None

---

Source

class CompletionsCreateRequestInputs

Pydantic Fields:

• model: <class 'str'>
• messages: <class 'list'>
• timeout: float | str | None
• temperature: float | None
• top_p: float | None
• n: int | None
• stop: str | list | None
• max_completion_tokens: int | None
• max_tokens: int | None
• modalities: list | None
• presence_penalty: float | None
• frequency_penalty: float | None
• stream: bool | None
• logit_bias: dict | None
• user: str | None
• response_format: dict | type[pydantic.main.BaseModel] | None
• seed: int | None
• tools: list | None
• tool_choice: str | dict | None
• logprobs: bool | None
• top_logprobs: int | None
• parallel_tool_calls: bool | None
• extra_headers: dict | None
• functions: list | None
• function_call: str | None
• api_version: str | None
• prompt: str | None
• template_vars: dict[str, typing.Any] | None

---

Source

class CompletionsCreateRes

Pydantic Fields:

• response: dict[str, typing.Any]
• weave_call_id: str | None

---

Source

class CostCreateInput

Pydantic Fields:

• prompt_token_cost: <class 'float'>
• completion_token_cost: <class 'float'>
• prompt_token_cost_unit: str | None
• completion_token_cost_unit: str | None
• effective_date: datetime.datetime | None
• provider_id: str | None

---

Source

class CostCreateReq

Pydantic Fields:

• project_id: <class 'str'>
• costs: dict[str, CostCreateInput]
• wb_user_id: str | None

---

Source

class CostCreateRes

Pydantic Fields:

• ids: list[tuple[str, str]]

---

Source

class CostPurgeReq

Pydantic Fields:

• project_id: <class 'str'>
• query: <class 'weave.trace_server.interface.query.Query'>

---

Source

class CostPurgeRes

---

Source

class CostQueryOutput

Pydantic Fields:

• id: str | None
• llm_id: str | None
• prompt_token_cost: float | None
• completion_token_cost: float | None
• prompt_token_cost_unit: str | None
• completion_token_cost_unit: str | None
• effective_date: datetime.datetime | None
• provider_id: str | None

---

Source

class CostQueryReq

Pydantic Fields:

• project_id: <class 'str'>
• fields: list[str] | None
• query: weave.trace_server.interface.query.Query | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None
• limit: int | None
• offset: int | None

---

Source

class CostQueryRes

Pydantic Fields:

• results: list[CostQueryOutput]

---

Source

class DatasetCreateBody

Pydantic Fields:

• name: str | None
• description: str | None
• rows: list[dict[str, typing.Any]]

---

Source

class DatasetCreateReq

Pydantic Fields:

• name: str | None
• description: str | None
• rows: list[dict[str, typing.Any]]
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class DatasetCreateRes

Pydantic Fields:

• digest: <class 'str'>
• object_id: <class 'str'>
• version_index: <class 'int'>

---

Source

class DatasetDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digests: list[str] | None
• wb_user_id: str | None

---

Source

class DatasetDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class DatasetListReq

Pydantic Fields:

• project_id: <class 'str'>
• limit: int | None
• offset: int | None
• wb_user_id: str | None

---

Source

class DatasetReadReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digest: <class 'str'>
• wb_user_id: str | None

---

Source

class DatasetReadRes

Pydantic Fields:

• object_id: <class 'str'>
• digest: <class 'str'>
• version_index: <class 'int'>
• created_at: <class 'datetime.datetime'>
• name: <class 'str'>
• description: str | None
• rows: <class 'str'>

---

Source

class EndedCallSchemaForInsert

Pydantic Fields:

• project_id: <class 'str'>
• id: <class 'str'>
• ended_at: <class 'datetime.datetime'>
• exception: str | None
• output: typing.Any | None
• summary: <class 'SummaryInsertMap'>
• wb_run_step_end: int | None

Source

method serialize_typed_dicts

serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any]

---

Source

class EnsureProjectExistsRes

Pydantic Fields:

• project_name: <class 'str'>

---

Source

class EvaluateModelReq

Pydantic Fields:

• project_id: <class 'str'>
• evaluation_ref: <class 'str'>
• model_ref: <class 'str'>
• wb_user_id: str | None

---

Source

class EvaluateModelRes

Pydantic Fields:

• call_id: <class 'str'>

---

Source

class EvaluationCreateBody

Pydantic Fields:

• name: <class 'str'>
• description: str | None
• dataset: <class 'str'>
• scorers: list[str] | None
• trials: <class 'int'>
• evaluation_name: str | None
• eval_attributes: dict[str, typing.Any] | None

---

Source

class EvaluationCreateReq

Pydantic Fields:

• name: <class 'str'>
• description: str | None
• dataset: <class 'str'>
• scorers: list[str] | None
• trials: <class 'int'>
• evaluation_name: str | None
• eval_attributes: dict[str, typing.Any] | None
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class EvaluationCreateRes

Pydantic Fields:

• digest: <class 'str'>
• object_id: <class 'str'>
• version_index: <class 'int'>
• evaluation_ref: <class 'str'>

---

Source

class EvaluationDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digests: list[str] | None
• wb_user_id: str | None

---

Source

class EvaluationDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class EvaluationListReq

Pydantic Fields:

• project_id: <class 'str'>
• limit: int | None
• offset: int | None
• wb_user_id: str | None

---

Source

class EvaluationReadReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digest: <class 'str'>
• wb_user_id: str | None

---

Source

class EvaluationReadRes

Pydantic Fields:

• object_id: <class 'str'>
• digest: <class 'str'>
• version_index: <class 'int'>
• created_at: <class 'datetime.datetime'>
• name: <class 'str'>
• description: str | None
• dataset: <class 'str'>
• scorers: list[str]
• trials: <class 'int'>
• evaluation_name: str | None
• evaluate_op: str | None
• predict_and_score_op: str | None
• summarize_op: str | None

---

Source

class EvaluationRunCreateBody

Pydantic Fields:

• evaluation: <class 'str'>
• model: <class 'str'>

---

Source

class EvaluationRunCreateReq

Pydantic Fields:

• evaluation: <class 'str'>
• model: <class 'str'>
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class EvaluationRunCreateRes

Pydantic Fields:

• evaluation_run_id: <class 'str'>

---

Source

class EvaluationRunDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• evaluation_run_ids: list[str]
• wb_user_id: str | None

---

Source

class EvaluationRunDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class EvaluationRunFilter

Pydantic Fields:

• evaluations: list[str] | None
• models: list[str] | None
• evaluation_run_ids: list[str] | None

---

Source

class EvaluationRunFinishBody

Request body for finishing an evaluation run via REST API.

This model excludes project_id and evaluation_run_id since they come from the URL path in RESTful endpoints.

Pydantic Fields:

• summary: dict[str, typing.Any] | None

---

Source

class EvaluationRunFinishReq

Pydantic Fields:

• summary: dict[str, typing.Any] | None
• project_id: <class 'str'>
• evaluation_run_id: <class 'str'>
• wb_user_id: str | None

---

Source

class EvaluationRunFinishRes

Pydantic Fields:

• success: <class 'bool'>

---

Source

class EvaluationRunListReq

Pydantic Fields:

• project_id: <class 'str'>
• filter: EvaluationRunFilter | None
• limit: int | None
• offset: int | None

---

Source

class EvaluationRunReadReq

Pydantic Fields:

• project_id: <class 'str'>
• evaluation_run_id: <class 'str'>

---

Source

class EvaluationRunReadRes

Pydantic Fields:

• evaluation_run_id: <class 'str'>
• evaluation: <class 'str'>
• model: <class 'str'>
• status: str | None
• started_at: datetime.datetime | None
• finished_at: datetime.datetime | None
• summary: dict[str, typing.Any] | None

---

Source

class EvaluationStatusComplete

Pydantic Fields:

• code: typing.Literal['complete']
• output: dict[str, typing.Any]

---

Source

class EvaluationStatusFailed

Pydantic Fields:

• code: typing.Literal['failed']
• error: str | None

---

Source

class EvaluationStatusNotFound

Pydantic Fields:

• code: typing.Literal['not_found']

---

Source

class EvaluationStatusReq

Pydantic Fields:

• project_id: <class 'str'>
• call_id: <class 'str'>

---

Source

class EvaluationStatusRes

Pydantic Fields:

• status: EvaluationStatusNotFound | EvaluationStatusRunning | EvaluationStatusFailed | EvaluationStatusComplete

---

Source

class EvaluationStatusRunning

Pydantic Fields:

• code: typing.Literal['running']
• completed_rows: <class 'int'>
• total_rows: <class 'int'>

---

Source

class ExportTracePartialSuccess

Pydantic Fields:

• rejected_spans: <class 'int'>
• error_message: <class 'str'>

---

Source

class ExtraKeysTypedDict

---

Source

class Feedback

Pydantic Fields:

• id: <class 'str'>
• project_id: <class 'str'>
• weave_ref: <class 'str'>
• creator: str | None
• feedback_type: <class 'str'>
• payload: dict[str, typing.Any]
• annotation_ref: str | None
• runnable_ref: str | None
• call_ref: str | None
• trigger_ref: str | None
• wb_user_id: str | None
• created_at: <class 'datetime.datetime'>

---

Source

class FeedbackCreateBatchReq

Pydantic Fields:

• batch: list[FeedbackCreateReq]

---

Source

class FeedbackCreateBatchRes

Pydantic Fields:

• res: list[FeedbackCreateRes]

---

Source

class FeedbackCreateReq

Pydantic Fields:

• id: str | None
• project_id: <class 'str'>
• weave_ref: <class 'str'>
• creator: str | None
• feedback_type: <class 'str'>
• payload: dict[str, typing.Any]
• annotation_ref: str | None
• runnable_ref: str | None
• call_ref: str | None
• trigger_ref: str | None
• wb_user_id: str | None

---

Source

class FeedbackCreateRes

Pydantic Fields:

• id: <class 'str'>
• created_at: <class 'datetime.datetime'>
• wb_user_id: <class 'str'>
• payload: dict[str, typing.Any]

---

Source

class FeedbackDict

---

Source

class FeedbackPurgeReq

Pydantic Fields:

• project_id: <class 'str'>
• query: <class 'weave.trace_server.interface.query.Query'>

---

Source

class FeedbackPurgeRes

---

Source

class FeedbackQueryReq

Pydantic Fields:

• project_id: <class 'str'>
• fields: list[str] | None
• query: weave.trace_server.interface.query.Query | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None
• limit: int | None
• offset: int | None

---

Source

class FeedbackQueryRes

Pydantic Fields:

• result: list[dict[str, typing.Any]]

---

Source

class FeedbackReplaceReq

Pydantic Fields:

• id: str | None
• project_id: <class 'str'>
• weave_ref: <class 'str'>
• creator: str | None
• feedback_type: <class 'str'>
• payload: dict[str, typing.Any]
• annotation_ref: str | None
• runnable_ref: str | None
• call_ref: str | None
• trigger_ref: str | None
• wb_user_id: str | None
• feedback_id: <class 'str'>

---

Source

class FeedbackReplaceRes

Pydantic Fields:

• id: <class 'str'>
• created_at: <class 'datetime.datetime'>
• wb_user_id: <class 'str'>
• payload: dict[str, typing.Any]

---

Source

class FileContentReadReq

Pydantic Fields:

• project_id: <class 'str'>
• digest: <class 'str'>

---

Source

class FileContentReadRes

Pydantic Fields:

• content: <class 'bytes'>

---

Source

class FileCreateReq

Pydantic Fields:

• project_id: <class 'str'>
• name: <class 'str'>
• content: <class 'bytes'>

---

Source

class FileCreateRes

Pydantic Fields:

• digest: <class 'str'>

---

Source

class FilesStatsReq

Pydantic Fields:

• project_id: <class 'str'>

---

Source

class FilesStatsRes

Pydantic Fields:

• total_size_bytes: <class 'int'>

---

Source

class FullTraceServerInterface

Complete trace server interface supporting both V1 and Object APIs.

This protocol represents a trace server implementation that supports the full set of APIs - both legacy V1 endpoints and modern Object endpoints. Use this type for implementations that need to support both API versions.

---

Source

method actions_execute_batch

actions_execute_batch(req: ActionsExecuteBatchReq) → ActionsExecuteBatchRes

---

Source

method annotation_queue_add_calls

annotation_queue_add_calls(
    req: AnnotationQueueAddCallsReq
) → AnnotationQueueAddCallsRes

---

Source

method annotation_queue_create

annotation_queue_create(
    req: AnnotationQueueCreateReq
) → AnnotationQueueCreateRes

---

Source

method annotation_queue_items_query

annotation_queue_items_query(
    req: AnnotationQueueItemsQueryReq
) → AnnotationQueueItemsQueryRes

---

Source

method annotation_queue_read

annotation_queue_read(req: AnnotationQueueReadReq) → AnnotationQueueReadRes

---

Source

method annotation_queues_query_stream

annotation_queues_query_stream(
    req: AnnotationQueuesQueryReq
) → Iterator[AnnotationQueueSchema]

---

Source

method annotation_queues_stats

annotation_queues_stats(
    req: AnnotationQueuesStatsReq
) → AnnotationQueuesStatsRes

---

Source

method annotator_queue_items_progress_update

annotator_queue_items_progress_update(
    req: AnnotatorQueueItemsProgressUpdateReq
) → AnnotatorQueueItemsProgressUpdateRes

---

Source

method call_end

call_end(req: CallEndReq) → CallEndRes

---

Source

method call_read

call_read(req: CallReadReq) → CallReadRes

---

Source

method call_start

call_start(req: CallStartReq) → CallStartRes

---

Source

method call_start_batch

call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes

---

Source

method call_update

call_update(req: CallUpdateReq) → CallUpdateRes

---

Source

method calls_delete

calls_delete(req: CallsDeleteReq) → CallsDeleteRes

---

Source

method calls_query

calls_query(req: CallsQueryReq) → CallsQueryRes

---

Source

method calls_query_stats

calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes

---

Source

method calls_query_stream

calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema]

---

Source

method completions_create

completions_create(req: CompletionsCreateReq) → CompletionsCreateRes

---

Source

method completions_create_stream

completions_create_stream(req: CompletionsCreateReq) → Iterator[dict[str, Any]]

---

Source

method cost_create

cost_create(req: CostCreateReq) → CostCreateRes

---

Source

method cost_purge

cost_purge(req: CostPurgeReq) → CostPurgeRes

---

Source

method cost_query

cost_query(req: CostQueryReq) → CostQueryRes

---

Source

method dataset_create

dataset_create(req: DatasetCreateReq) → DatasetCreateRes

---

Source

method dataset_delete

dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes

---

Source

method dataset_list

dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes]

---

Source

method dataset_read

dataset_read(req: DatasetReadReq) → DatasetReadRes

---

Source

method ensure_project_exists

ensure_project_exists(entity: str, project: str) → EnsureProjectExistsRes

---

Source

method evaluate_model

evaluate_model(req: EvaluateModelReq) → EvaluateModelRes

---

Source

method evaluation_create

evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes

---

Source

method evaluation_delete

evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes

---

Source

method evaluation_list

evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes]

---

Source

method evaluation_read

evaluation_read(req: EvaluationReadReq) → EvaluationReadRes

---

Source

method evaluation_run_create

evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes

---

Source

method evaluation_run_delete

evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes

---

Source

method evaluation_run_finish

evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes

---

Source

method evaluation_run_list

evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes]

---

Source

method evaluation_run_read

evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes

---

Source

method evaluation_status

evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes

---

Source

method feedback_create

feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes

---

Source

method feedback_create_batch

feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes

---

Source

method feedback_purge

feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes

---

Source

method feedback_query

feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes

---

Source

method feedback_replace

feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes

---

Source

method file_content_read

file_content_read(req: FileContentReadReq) → FileContentReadRes

---

Source

method file_create

file_create(req: FileCreateReq) → FileCreateRes

---

Source

method files_stats

files_stats(req: FilesStatsReq) → FilesStatsRes

---

Source

method image_create

image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes

---

Source

method model_create

model_create(req: ModelCreateReq) → ModelCreateRes

---

Source

method model_delete

model_delete(req: ModelDeleteReq) → ModelDeleteRes

---

Source

method model_list

model_list(req: ModelListReq) → Iterator[ModelReadRes]

---

Source

method model_read

model_read(req: ModelReadReq) → ModelReadRes

---

Source

method obj_create

obj_create(req: ObjCreateReq) → ObjCreateRes

---

Source

method obj_delete

obj_delete(req: ObjDeleteReq) → ObjDeleteRes

---

Source

method obj_read

obj_read(req: ObjReadReq) → ObjReadRes

---

Source

method objs_query

objs_query(req: ObjQueryReq) → ObjQueryRes

---

Source

method op_create

op_create(req: OpCreateReq) → OpCreateRes

---

Source

method op_delete

op_delete(req: OpDeleteReq) → OpDeleteRes

---

Source

method op_list

op_list(req: OpListReq) → Iterator[OpReadRes]

---

Source

method op_read

op_read(req: OpReadReq) → OpReadRes

---

Source

method otel_export

otel_export(req: OtelExportReq) → OtelExportRes

---

Source

method prediction_create

prediction_create(req: PredictionCreateReq) → PredictionCreateRes

---

Source

method prediction_delete

prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes

---

Source

method prediction_finish

prediction_finish(req: PredictionFinishReq) → PredictionFinishRes

---

Source

method prediction_list

prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes]

---

Source

method prediction_read

prediction_read(req: PredictionReadReq) → PredictionReadRes

---

Source

method project_stats

project_stats(req: ProjectStatsReq) → ProjectStatsRes

---

Source

method refs_read_batch

refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes

---

Source

method score_create

score_create(req: ScoreCreateReq) → ScoreCreateRes

---

Source

method score_delete

score_delete(req: ScoreDeleteReq) → ScoreDeleteRes

---

Source

method score_list

score_list(req: ScoreListReq) → Iterator[ScoreReadRes]

---

Source

method score_read

score_read(req: ScoreReadReq) → ScoreReadRes

---

Source

method scorer_create

scorer_create(req: ScorerCreateReq) → ScorerCreateRes

---

Source

method scorer_delete

scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes

---

Source

method scorer_list

scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes]

---

Source

method scorer_read

scorer_read(req: ScorerReadReq) → ScorerReadRes

---

Source

method table_create

table_create(req: TableCreateReq) → TableCreateRes

---

Source

method table_create_from_digests

table_create_from_digests(
    req: TableCreateFromDigestsReq
) → TableCreateFromDigestsRes

---

Source

method table_query

table_query(req: TableQueryReq) → TableQueryRes

---

Source

method table_query_stats

table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes

---

Source

method table_query_stats_batch

table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes

---

Source

method table_query_stream

table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema]

---

Source

method table_update

table_update(req: TableUpdateReq) → TableUpdateRes

---

Source

method threads_query_stream

threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema]

---

Source

class ImageGenerationCreateReq

Pydantic Fields:

• project_id: <class 'str'>
• inputs: <class 'ImageGenerationRequestInputs'>
• wb_user_id: str | None
• track_llm_call: bool | None

---

Source

class ImageGenerationCreateRes

Pydantic Fields:

• response: dict[str, typing.Any]
• weave_call_id: str | None

---

Source

class ImageGenerationRequestInputs

Pydantic Fields:

• model: <class 'str'>
• prompt: <class 'str'>
• n: int | None

---

Source

class LLMCostSchema

---

Source

class LLMUsageSchema

---

Source

class ModelCreateBody

Pydantic Fields:

• name: <class 'str'>
• description: str | None
• source_code: <class 'str'>
• attributes: dict[str, typing.Any] | None

---

Source

class ModelCreateReq

Pydantic Fields:

• name: <class 'str'>
• description: str | None
• source_code: <class 'str'>
• attributes: dict[str, typing.Any] | None
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class ModelCreateRes

Pydantic Fields:

• digest: <class 'str'>
• object_id: <class 'str'>
• version_index: <class 'int'>
• model_ref: <class 'str'>

---

Source

class ModelDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digests: list[str] | None
• wb_user_id: str | None

---

Source

class ModelDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class ModelListReq

Pydantic Fields:

• project_id: <class 'str'>
• limit: int | None
• offset: int | None

---

Source

class ModelReadReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digest: <class 'str'>

---

Source

class ModelReadRes

Pydantic Fields:

• object_id: <class 'str'>
• digest: <class 'str'>
• version_index: <class 'int'>
• created_at: <class 'datetime.datetime'>
• name: <class 'str'>
• description: str | None
• source_code: <class 'str'>
• attributes: dict[str, typing.Any] | None

---

Source

class ObjCreateReq

Pydantic Fields:

• obj: <class 'ObjSchemaForInsert'>

---

Source

class ObjCreateRes

Pydantic Fields:

• digest: <class 'str'>
• object_id: str | None

---

Source

class ObjDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digests: list[str] | None

---

Source

class ObjDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class ObjQueryReq

Pydantic Fields:

• project_id: <class 'str'>
• filter: ObjectVersionFilter | None
• limit: int | None
• offset: int | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None
• metadata_only: bool | None
• include_storage_size: bool | None

---

Source

class ObjQueryRes

Pydantic Fields:

• objs: list[ObjSchema]

---

Source

class ObjReadReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digest: <class 'str'>
• metadata_only: bool | None

---

Source

class ObjReadRes

Pydantic Fields:

• obj: <class 'ObjSchema'>

---

Source

class ObjSchema

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• created_at: <class 'datetime.datetime'>
• deleted_at: datetime.datetime | None
• digest: <class 'str'>
• version_index: <class 'int'>
• is_latest: <class 'int'>
• kind: <class 'str'>
• base_object_class: str | None
• leaf_object_class: str | None
• val: typing.Any
• wb_user_id: str | None
• size_bytes: int | None

---

Source

class ObjSchemaForInsert

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• val: typing.Any
• builtin_object_class: str | None
• set_base_object_class: str | None
• wb_user_id: str | None

Source

method model_post_init

model_post_init(_ObjSchemaForInsert__context: Any) → None

---

Source

class ObjectInterface

Object API endpoints for Trace Server.

This protocol contains object management APIs that provide cleaner, more RESTful interfaces. Implementations should support both this protocol and TraceServerInterface to maintain backward compatibility.

---

Source

method dataset_create

dataset_create(req: DatasetCreateReq) → DatasetCreateRes

---

Source

method dataset_delete

dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes

---

Source

method dataset_list

dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes]

---

Source

method dataset_read

dataset_read(req: DatasetReadReq) → DatasetReadRes

---

Source

method evaluation_create

evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes

---

Source

method evaluation_delete

evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes

---

Source

method evaluation_list

evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes]

---

Source

method evaluation_read

evaluation_read(req: EvaluationReadReq) → EvaluationReadRes

---

Source

method evaluation_run_create

evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes

---

Source

method evaluation_run_delete

evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes

---

Source

method evaluation_run_finish

evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes

---

Source

method evaluation_run_list

evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes]

---

Source

method evaluation_run_read

evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes

---

Source

method model_create

model_create(req: ModelCreateReq) → ModelCreateRes

---

Source

method model_delete

model_delete(req: ModelDeleteReq) → ModelDeleteRes

---

Source

method model_list

model_list(req: ModelListReq) → Iterator[ModelReadRes]

---

Source

method model_read

model_read(req: ModelReadReq) → ModelReadRes

---

Source

method op_create

op_create(req: OpCreateReq) → OpCreateRes

---

Source

method op_delete

op_delete(req: OpDeleteReq) → OpDeleteRes

---

Source

method op_list

op_list(req: OpListReq) → Iterator[OpReadRes]

---

Source

method op_read

op_read(req: OpReadReq) → OpReadRes

---

Source

method prediction_create

prediction_create(req: PredictionCreateReq) → PredictionCreateRes

---

Source

method prediction_delete

prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes

---

Source

method prediction_finish

prediction_finish(req: PredictionFinishReq) → PredictionFinishRes

---

Source

method prediction_list

prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes]

---

Source

method prediction_read

prediction_read(req: PredictionReadReq) → PredictionReadRes

---

Source

method score_create

score_create(req: ScoreCreateReq) → ScoreCreateRes

---

Source

method score_delete

score_delete(req: ScoreDeleteReq) → ScoreDeleteRes

---

Source

method score_list

score_list(req: ScoreListReq) → Iterator[ScoreReadRes]

---

Source

method score_read

score_read(req: ScoreReadReq) → ScoreReadRes

---

Source

method scorer_create

scorer_create(req: ScorerCreateReq) → ScorerCreateRes

---

Source

method scorer_delete

scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes

---

Source

method scorer_list

scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes]

---

Source

method scorer_read

scorer_read(req: ScorerReadReq) → ScorerReadRes

---

Source

class ObjectVersionFilter

Pydantic Fields:

• base_object_classes: list[str] | None
• exclude_base_object_classes: list[str] | None
• leaf_object_classes: list[str] | None
• object_ids: list[str] | None
• is_op: bool | None
• latest_only: bool | None

---

Source

class OpCreateBody

Request body for creating an Op object via REST API.

This model excludes project_id since it comes from the URL path in RESTful endpoints.

Pydantic Fields:

• name: str | None
• source_code: str | None

---

Source

class OpCreateReq

Request model for creating an Op object.

Extends OpCreateBody by adding project_id for internal API usage.

Pydantic Fields:

• name: str | None
• source_code: str | None
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class OpCreateRes

Response model for creating an Op object.

Pydantic Fields:

• digest: <class 'str'>
• object_id: <class 'str'>
• version_index: <class 'int'>

---

Source

class OpDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digests: list[str] | None
• wb_user_id: str | None

---

Source

class OpDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class OpListReq

Pydantic Fields:

• project_id: <class 'str'>
• limit: int | None
• offset: int | None
• wb_user_id: str | None

---

Source

class OpReadReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digest: <class 'str'>
• wb_user_id: str | None

---

Source

class OpReadRes

Response model for reading an Op object.

The code field contains the actual source code of the op.

Pydantic Fields:

• object_id: <class 'str'>
• digest: <class 'str'>
• version_index: <class 'int'>
• created_at: <class 'datetime.datetime'>
• code: <class 'str'>

---

Source

class OtelExportReq

Pydantic Fields:

• project_id: <class 'str'>
• traces: typing.Any
• wb_run_id: str | None
• wb_user_id: str | None

---

Source

class OtelExportRes

Pydantic Fields:

• partial_success: ExportTracePartialSuccess | None

---

Source

class PredictionCreateBody

Request body for creating a Prediction via REST API.

This model excludes project_id since it comes from the URL path in RESTful endpoints.

Pydantic Fields:

• model: <class 'str'>
• inputs: dict[str, typing.Any]
• output: typing.Any
• evaluation_run_id: str | None

---

Source

class PredictionCreateReq

Request model for creating a Prediction.

Extends PredictionCreateBody by adding project_id for internal API usage.

Pydantic Fields:

• model: <class 'str'>
• inputs: dict[str, typing.Any]
• output: typing.Any
• evaluation_run_id: str | None
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class PredictionCreateRes

Pydantic Fields:

• prediction_id: <class 'str'>

---

Source

class PredictionDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• prediction_ids: list[str]
• wb_user_id: str | None

---

Source

class PredictionDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class PredictionFinishReq

Pydantic Fields:

• project_id: <class 'str'>
• prediction_id: <class 'str'>
• wb_user_id: str | None

---

Source

class PredictionFinishRes

Pydantic Fields:

• success: <class 'bool'>

---

Source

class PredictionListReq

Pydantic Fields:

• project_id: <class 'str'>
• evaluation_run_id: str | None
• limit: int | None
• offset: int | None
• wb_user_id: str | None

---

Source

class PredictionListRes

Pydantic Fields:

• predictions: list[PredictionReadRes]

---

Source

class PredictionReadReq

Pydantic Fields:

• project_id: <class 'str'>
• prediction_id: <class 'str'>
• wb_user_id: str | None

---

Source

class PredictionReadRes

Pydantic Fields:

• prediction_id: <class 'str'>
• model: <class 'str'>
• inputs: dict[str, typing.Any]
• output: typing.Any
• evaluation_run_id: str | None
• wb_user_id: str | None

---

Source

class ProjectStatsReq

Pydantic Fields:

• project_id: <class 'str'>
• include_trace_storage_size: bool | None
• include_object_storage_size: bool | None
• include_table_storage_size: bool | None
• include_file_storage_size: bool | None

---

Source

class ProjectStatsRes

Pydantic Fields:

• trace_storage_size_bytes: <class 'int'>
• objects_storage_size_bytes: <class 'int'>
• tables_storage_size_bytes: <class 'int'>
• files_storage_size_bytes: <class 'int'>

---

Source

class RefsReadBatchReq

Pydantic Fields:

• refs: list[str]

---

Source

class RefsReadBatchRes

Pydantic Fields:

• vals: list[typing.Any]

---

Source

class ScoreCreateBody

Request body for creating a Score via REST API.

This model excludes project_id since it comes from the URL path in RESTful endpoints.

Pydantic Fields:

• prediction_id: <class 'str'>
• scorer: <class 'str'>
• value: <class 'float'>
• evaluation_run_id: str | None

---

Source

class ScoreCreateReq

Request model for creating a Score.

Extends ScoreCreateBody by adding project_id for internal API usage.

Pydantic Fields:

• prediction_id: <class 'str'>
• scorer: <class 'str'>
• value: <class 'float'>
• evaluation_run_id: str | None
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class ScoreCreateRes

Pydantic Fields:

• score_id: <class 'str'>

---

Source

class ScoreDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• score_ids: list[str]
• wb_user_id: str | None

---

Source

class ScoreDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class ScoreListReq

Pydantic Fields:

• project_id: <class 'str'>
• evaluation_run_id: str | None
• limit: int | None
• offset: int | None
• wb_user_id: str | None

---

Source

class ScoreReadReq

Pydantic Fields:

• project_id: <class 'str'>
• score_id: <class 'str'>
• wb_user_id: str | None

---

Source

class ScoreReadRes

Pydantic Fields:

• score_id: <class 'str'>
• scorer: <class 'str'>
• value: <class 'float'>
• evaluation_run_id: str | None
• wb_user_id: str | None

---

Source

class ScorerCreateBody

Pydantic Fields:

• name: <class 'str'>
• description: str | None
• op_source_code: <class 'str'>

---

Source

class ScorerCreateReq

Pydantic Fields:

• name: <class 'str'>
• description: str | None
• op_source_code: <class 'str'>
• project_id: <class 'str'>
• wb_user_id: str | None

---

Source

class ScorerCreateRes

Pydantic Fields:

• digest: <class 'str'>
• object_id: <class 'str'>
• version_index: <class 'int'>
• scorer: <class 'str'>

---

Source

class ScorerDeleteReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digests: list[str] | None
• wb_user_id: str | None

---

Source

class ScorerDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

Source

class ScorerListReq

Pydantic Fields:

• project_id: <class 'str'>
• limit: int | None
• offset: int | None
• wb_user_id: str | None

---

Source

class ScorerReadReq

Pydantic Fields:

• project_id: <class 'str'>
• object_id: <class 'str'>
• digest: <class 'str'>
• wb_user_id: str | None

---

Source

class ScorerReadRes

Pydantic Fields:

• object_id: <class 'str'>
• digest: <class 'str'>
• version_index: <class 'int'>
• created_at: <class 'datetime.datetime'>
• name: <class 'str'>
• description: str | None
• score_op: <class 'str'>

---

Source

class StartedCallSchemaForInsert

Pydantic Fields:

• project_id: <class 'str'>
• id: str | None
• op_name: <class 'str'>
• display_name: str | None
• trace_id: str | None
• parent_id: str | None
• thread_id: str | None
• turn_id: str | None
• started_at: <class 'datetime.datetime'>
• attributes: dict[str, typing.Any]
• inputs: dict[str, typing.Any]
• otel_dump: dict[str, typing.Any] | None
• wb_user_id: str | None
• wb_run_id: str | None
• wb_run_step: int | None

---

Source

class SummaryInsertMap

---

Source

class SummaryMap

---

Source

class TableAppendSpec

Pydantic Fields:

• append: <class 'TableAppendSpecPayload'>

---

Source

class TableAppendSpecPayload

Pydantic Fields:

• row: dict[str, typing.Any]

---

Source

class TableCreateFromDigestsReq

Pydantic Fields:

• project_id: <class 'str'>
• row_digests: list[str]

---

Source

class TableCreateFromDigestsRes

Pydantic Fields:

• digest: <class 'str'>

---

Source

class TableCreateReq

Pydantic Fields:

• table: <class 'TableSchemaForInsert'>

---

Source

class TableCreateRes

Pydantic Fields:

• digest: <class 'str'>
• row_digests: list[str]

---

Source

class TableInsertSpec

Pydantic Fields:

• insert: <class 'TableInsertSpecPayload'>

---

Source

class TableInsertSpecPayload

Pydantic Fields:

• index: <class 'int'>
• row: dict[str, typing.Any]

---

Source

class TablePopSpec

Pydantic Fields:

• pop: <class 'TablePopSpecPayload'>

---

Source

class TablePopSpecPayload

Pydantic Fields:

• index: <class 'int'>

---

Source

class TableQueryReq

Pydantic Fields:

• project_id: <class 'str'>
• digest: <class 'str'>
• filter: TableRowFilter | None
• limit: int | None
• offset: int | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None

---

Source

class TableQueryRes

Pydantic Fields:

• rows: list[TableRowSchema]

---

Source

class TableQueryStatsBatchReq

Pydantic Fields:

• project_id: <class 'str'>
• digests: list[str] | None
• include_storage_size: bool | None

---

Source

class TableQueryStatsBatchRes

Pydantic Fields:

• tables: list[TableStatsRow]

---

Source

class TableQueryStatsReq

Pydantic Fields:

• project_id: <class 'str'>
• digest: <class 'str'>

---

Source

class TableQueryStatsRes

Pydantic Fields:

• count: <class 'int'>

---

Source

class TableRowFilter

Pydantic Fields:

• row_digests: list[str] | None

---

Source

class TableRowSchema

Pydantic Fields:

• digest: <class 'str'>
• val: typing.Any
• original_index: int | None

---

Source

class TableSchemaForInsert

Pydantic Fields:

• project_id: <class 'str'>
• rows: list[dict[str, typing.Any]]

---

Source

class TableStatsRow

Pydantic Fields:

• count: <class 'int'>
• digest: <class 'str'>
• storage_size_bytes: int | None

---

Source

class TableUpdateReq

Pydantic Fields:

• project_id: <class 'str'>
• base_digest: <class 'str'>
• updates: list[TableAppendSpec | TablePopSpec | TableInsertSpec]

---

Source

class TableUpdateRes

Pydantic Fields:

• digest: <class 'str'>
• updated_row_digests: list[str]

---

Source

class ThreadSchema

Pydantic Fields:

• thread_id: <class 'str'>
• turn_count: <class 'int'>
• start_time: <class 'datetime.datetime'>
• last_updated: <class 'datetime.datetime'>
• first_turn_id: str | None
• last_turn_id: str | None
• p50_turn_duration_ms: float | None
• p99_turn_duration_ms: float | None

---

Source

class ThreadsQueryFilter

Pydantic Fields:

• after_datetime: datetime.datetime | None
• before_datetime: datetime.datetime | None
• thread_ids: list[str] | None

---

Source

class ThreadsQueryReq

Query threads with aggregated statistics based on turn calls only.

Turn calls are the immediate children of thread contexts (where call.id == turn_id). This provides meaningful conversation-level statistics rather than including all nested implementation details.

Pydantic Fields:

• project_id: <class 'str'>
• filter: ThreadsQueryFilter | None
• limit: int | None
• offset: int | None
• sort_by: list[weave.trace_server.common_interface.SortBy] | None

---

Source

class TraceServerInterface

---

Source

method actions_execute_batch

actions_execute_batch(req: ActionsExecuteBatchReq) → ActionsExecuteBatchRes

---

Source

method annotation_queue_add_calls

annotation_queue_add_calls(
    req: AnnotationQueueAddCallsReq
) → AnnotationQueueAddCallsRes

---

Source

method annotation_queue_create

annotation_queue_create(
    req: AnnotationQueueCreateReq
) → AnnotationQueueCreateRes

---

Source

method annotation_queue_items_query

annotation_queue_items_query(
    req: AnnotationQueueItemsQueryReq
) → AnnotationQueueItemsQueryRes

---

Source

method annotation_queue_read

annotation_queue_read(req: AnnotationQueueReadReq) → AnnotationQueueReadRes

---

Source

method annotation_queues_query_stream

annotation_queues_query_stream(
    req: AnnotationQueuesQueryReq
) → Iterator[AnnotationQueueSchema]

---

Source

method annotation_queues_stats

annotation_queues_stats(
    req: AnnotationQueuesStatsReq
) → AnnotationQueuesStatsRes

---

Source

method annotator_queue_items_progress_update

annotator_queue_items_progress_update(
    req: AnnotatorQueueItemsProgressUpdateReq
) → AnnotatorQueueItemsProgressUpdateRes

---

Source

method call_end

call_end(req: CallEndReq) → CallEndRes

---

Source

method call_read

call_read(req: CallReadReq) → CallReadRes

---

Source

method call_start

call_start(req: CallStartReq) → CallStartRes

---

Source

method call_start_batch

call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes

---

Source

method call_update

call_update(req: CallUpdateReq) → CallUpdateRes

---

Source

method calls_delete

calls_delete(req: CallsDeleteReq) → CallsDeleteRes

---

Source

method calls_query

calls_query(req: CallsQueryReq) → CallsQueryRes

---

Source

method calls_query_stats

calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes

---

Source

method calls_query_stream

calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema]

---

Source

method completions_create

completions_create(req: CompletionsCreateReq) → CompletionsCreateRes

---

Source

method completions_create_stream

completions_create_stream(req: CompletionsCreateReq) → Iterator[dict[str, Any]]

---

Source

method cost_create

cost_create(req: CostCreateReq) → CostCreateRes

---

Source

method cost_purge

cost_purge(req: CostPurgeReq) → CostPurgeRes

---

Source

method cost_query

cost_query(req: CostQueryReq) → CostQueryRes

---

Source

method ensure_project_exists

ensure_project_exists(entity: str, project: str) → EnsureProjectExistsRes

---

Source

method evaluate_model

evaluate_model(req: EvaluateModelReq) → EvaluateModelRes

---

Source

method evaluation_status

evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes

---

Source

method feedback_create

feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes

---

Source

method feedback_create_batch

feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes

---

Source

method feedback_purge

feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes

---

Source

method feedback_query

feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes

---

Source

method feedback_replace

feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes

---

Source

method file_content_read

file_content_read(req: FileContentReadReq) → FileContentReadRes

---

Source

method file_create

file_create(req: FileCreateReq) → FileCreateRes

---

Source

method files_stats

files_stats(req: FilesStatsReq) → FilesStatsRes

---

Source

method image_create

image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes

---

Source

method obj_create

obj_create(req: ObjCreateReq) → ObjCreateRes

---

Source

method obj_delete

obj_delete(req: ObjDeleteReq) → ObjDeleteRes

---

Source

method obj_read

obj_read(req: ObjReadReq) → ObjReadRes

---

Source

method objs_query

objs_query(req: ObjQueryReq) → ObjQueryRes

---

Source

method otel_export

otel_export(req: OtelExportReq) → OtelExportRes

---

Source

method project_stats

project_stats(req: ProjectStatsReq) → ProjectStatsRes

---

Source

method refs_read_batch

refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes

---

Source

method table_create

table_create(req: TableCreateReq) → TableCreateRes

---

Source

method table_create_from_digests

table_create_from_digests(
    req: TableCreateFromDigestsReq
) → TableCreateFromDigestsRes

---

Source

method table_query

table_query(req: TableQueryReq) → TableQueryRes

---

Source

method table_query_stats

table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes

---

Source

method table_query_stats_batch

table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes

---

Source

method table_query_stream

table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema]

---

Source

method table_update

table_update(req: TableUpdateReq) → TableUpdateRes

---

Source

method threads_query_stream

threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema]

---

Source

class TraceStatus

---

Source

class WeaveSummarySchema