trace_server_interface

Python SDK reference for weave.trace_server.trace_server_interface

API Overview

---

class ActionsExecuteBatchReq

Pydantic Fields:

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

---

class ActionsExecuteBatchRes

---

class BaseModelStrict

Base model with strict validation that forbids extra fields.

---

class CallBatchEndMode

Pydantic Fields:

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

---

class CallBatchStartMode

Pydantic Fields:

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

---

class CallCreateBatchReq

Pydantic Fields:

• batch: list[CallBatchStartMode | CallBatchEndMode]

---

class CallCreateBatchRes

Pydantic Fields:

• res: list[CallStartRes | CallEndRes]

---

class CallEndReq

Pydantic Fields:

• end: <class 'EndedCallSchemaForInsert'>

---

class CallEndRes

---

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

---

class CallReadRes

Pydantic Fields:

• call: CallSchema | None

---

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

method serialize_typed_dicts

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

---

class CallStartReq

Pydantic Fields:

• start: <class 'StartedCallSchemaForInsert'>

---

class CallStartRes

Pydantic Fields:

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

---

class CallUpdateReq

Pydantic Fields:

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

---

class CallUpdateRes

---

class CallsDeleteReq

Pydantic Fields:

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

---

class CallsDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

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

---

class CallsQueryReq

Pydantic Fields:

• project_id: <class 'str'>
• filter: CallsFilter | None
• limit: int | None
• offset: int | None
• sort_by: list[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

---

class CallsQueryRes

Pydantic Fields:

• calls: list[CallSchema]

---

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

---

class CallsQueryStatsRes

Pydantic Fields:

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

---

class CompletionsCreateReq

Pydantic Fields:

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

---

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

---

class CompletionsCreateRes

Pydantic Fields:

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

---

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

---

class CostCreateReq

Pydantic Fields:

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

---

class CostCreateRes

Pydantic Fields:

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

---

class CostPurgeReq

Pydantic Fields:

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

---

class CostPurgeRes

---

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

---

class CostQueryReq

Pydantic Fields:

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

---

class CostQueryRes

Pydantic Fields:

• results: list[CostQueryOutput]

---

class DatasetCreateBody

Pydantic Fields:

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

---

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

---

class DatasetCreateRes

Pydantic Fields:

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

---

class DatasetDeleteReq

Pydantic Fields:

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

---

class DatasetDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class DatasetListReq

Pydantic Fields:

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

---

class DatasetReadReq

Pydantic Fields:

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

---

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

---

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

method serialize_typed_dicts

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

---

class EnsureProjectExistsRes

Pydantic Fields:

• project_name: <class 'str'>

---

class EvaluateModelReq

Pydantic Fields:

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

---

class EvaluateModelRes

Pydantic Fields:

• call_id: <class 'str'>

---

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

---

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

---

class EvaluationCreateRes

Pydantic Fields:

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

---

class EvaluationDeleteReq

Pydantic Fields:

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

---

class EvaluationDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class EvaluationListReq

Pydantic Fields:

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

---

class EvaluationReadReq

Pydantic Fields:

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

---

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

---

class EvaluationRunCreateBody

Pydantic Fields:

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

---

class EvaluationRunCreateReq

Pydantic Fields:

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

---

class EvaluationRunCreateRes

Pydantic Fields:

• evaluation_run_id: <class 'str'>

---

class EvaluationRunDeleteReq

Pydantic Fields:

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

---

class EvaluationRunDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class EvaluationRunFilter

Pydantic Fields:

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

---

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

---

class EvaluationRunFinishReq

Pydantic Fields:

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

---

class EvaluationRunFinishRes

Pydantic Fields:

• success: <class 'bool'>

---

class EvaluationRunListReq

Pydantic Fields:

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

---

class EvaluationRunReadReq

Pydantic Fields:

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

---

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

---

class EvaluationStatusComplete

Pydantic Fields:

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

---

class EvaluationStatusFailed

Pydantic Fields:

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

---

class EvaluationStatusNotFound

Pydantic Fields:

• code: typing.Literal['not_found']

---

class EvaluationStatusReq

Pydantic Fields:

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

---

class EvaluationStatusRes

Pydantic Fields:

• status: EvaluationStatusNotFound | EvaluationStatusRunning | EvaluationStatusFailed | EvaluationStatusComplete

---

class EvaluationStatusRunning

Pydantic Fields:

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

---

class ExportTracePartialSuccess

Pydantic Fields:

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

---

class ExtraKeysTypedDict

---

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

---

class FeedbackCreateBatchReq

Pydantic Fields:

• batch: list[FeedbackCreateReq]

---

class FeedbackCreateBatchRes

Pydantic Fields:

• res: list[FeedbackCreateRes]

---

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

---

class FeedbackCreateRes

Pydantic Fields:

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

---

class FeedbackDict

---

class FeedbackPurgeReq

Pydantic Fields:

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

---

class FeedbackPurgeRes

---

class FeedbackQueryReq

Pydantic Fields:

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

---

class FeedbackQueryRes

Pydantic Fields:

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

---

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

---

class FeedbackReplaceRes

Pydantic Fields:

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

---

class FileContentReadReq

Pydantic Fields:

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

---

class FileContentReadRes

Pydantic Fields:

• content: <class 'bytes'>

---

class FileCreateReq

Pydantic Fields:

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

---

class FileCreateRes

Pydantic Fields:

• digest: <class 'str'>

---

class FilesStatsReq

Pydantic Fields:

• project_id: <class 'str'>

---

class FilesStatsRes

Pydantic Fields:

• total_size_bytes: <class 'int'>

---

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.

---

method actions_execute_batch

actions_execute_batch(req: ActionsExecuteBatchReq) → ActionsExecuteBatchRes

---

method call_end

call_end(req: CallEndReq) → CallEndRes

---

method call_read

call_read(req: CallReadReq) → CallReadRes

---

method call_start

call_start(req: CallStartReq) → CallStartRes

---

method call_start_batch

call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes

---

method call_update

call_update(req: CallUpdateReq) → CallUpdateRes

---

method calls_delete

calls_delete(req: CallsDeleteReq) → CallsDeleteRes

---

method calls_query

calls_query(req: CallsQueryReq) → CallsQueryRes

---

method calls_query_stats

calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes

---

method calls_query_stream

calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema]

---

method completions_create

completions_create(req: CompletionsCreateReq) → CompletionsCreateRes

---

method completions_create_stream

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

---

method cost_create

cost_create(req: CostCreateReq) → CostCreateRes

---

method cost_purge

cost_purge(req: CostPurgeReq) → CostPurgeRes

---

method cost_query

cost_query(req: CostQueryReq) → CostQueryRes

---

method dataset_create

dataset_create(req: DatasetCreateReq) → DatasetCreateRes

---

method dataset_delete

dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes

---

method dataset_list

dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes]

---

method dataset_read

dataset_read(req: DatasetReadReq) → DatasetReadRes

---

method ensure_project_exists

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

---

method evaluate_model

evaluate_model(req: EvaluateModelReq) → EvaluateModelRes

---

method evaluation_create

evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes

---

method evaluation_delete

evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes

---

method evaluation_list

evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes]

---

method evaluation_read

evaluation_read(req: EvaluationReadReq) → EvaluationReadRes

---

method evaluation_run_create

evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes

---

method evaluation_run_delete

evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes

---

method evaluation_run_finish

evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes

---

method evaluation_run_list

evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes]

---

method evaluation_run_read

evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes

---

method evaluation_status

evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes

---

method feedback_create

feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes

---

method feedback_create_batch

feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes

---

method feedback_purge

feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes

---

method feedback_query

feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes

---

method feedback_replace

feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes

---

method file_content_read

file_content_read(req: FileContentReadReq) → FileContentReadRes

---

method file_create

file_create(req: FileCreateReq) → FileCreateRes

---

method files_stats

files_stats(req: FilesStatsReq) → FilesStatsRes

---

method image_create

image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes

---

method model_create

model_create(req: ModelCreateReq) → ModelCreateRes

---

method model_delete

model_delete(req: ModelDeleteReq) → ModelDeleteRes

---

method model_list

model_list(req: ModelListReq) → Iterator[ModelReadRes]

---

method model_read

model_read(req: ModelReadReq) → ModelReadRes

---

method obj_create

obj_create(req: ObjCreateReq) → ObjCreateRes

---

method obj_delete

obj_delete(req: ObjDeleteReq) → ObjDeleteRes

---

method obj_read

obj_read(req: ObjReadReq) → ObjReadRes

---

method objs_query

objs_query(req: ObjQueryReq) → ObjQueryRes

---

method op_create

op_create(req: OpCreateReq) → OpCreateRes

---

method op_delete

op_delete(req: OpDeleteReq) → OpDeleteRes

---

method op_list

op_list(req: OpListReq) → Iterator[OpReadRes]

---

method op_read

op_read(req: OpReadReq) → OpReadRes

---

method otel_export

otel_export(req: OtelExportReq) → OtelExportRes

---

method prediction_create

prediction_create(req: PredictionCreateReq) → PredictionCreateRes

---

method prediction_delete

prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes

---

method prediction_finish

prediction_finish(req: PredictionFinishReq) → PredictionFinishRes

---

method prediction_list

prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes]

---

method prediction_read

prediction_read(req: PredictionReadReq) → PredictionReadRes

---

method project_stats

project_stats(req: ProjectStatsReq) → ProjectStatsRes

---

method refs_read_batch

refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes

---

method score_create

score_create(req: ScoreCreateReq) → ScoreCreateRes

---

method score_delete

score_delete(req: ScoreDeleteReq) → ScoreDeleteRes

---

method score_list

score_list(req: ScoreListReq) → Iterator[ScoreReadRes]

---

method score_read

score_read(req: ScoreReadReq) → ScoreReadRes

---

method scorer_create

scorer_create(req: ScorerCreateReq) → ScorerCreateRes

---

method scorer_delete

scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes

---

method scorer_list

scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes]

---

method scorer_read

scorer_read(req: ScorerReadReq) → ScorerReadRes

---

method table_create

table_create(req: TableCreateReq) → TableCreateRes

---

method table_create_from_digests

table_create_from_digests(
    req: TableCreateFromDigestsReq
) → TableCreateFromDigestsRes

---

method table_query

table_query(req: TableQueryReq) → TableQueryRes

---

method table_query_stats

table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes

---

method table_query_stats_batch

table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes

---

method table_query_stream

table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema]

---

method table_update

table_update(req: TableUpdateReq) → TableUpdateRes

---

method threads_query_stream

threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema]

---

class ImageGenerationCreateReq

Pydantic Fields:

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

---

class ImageGenerationCreateRes

Pydantic Fields:

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

---

class ImageGenerationRequestInputs

Pydantic Fields:

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

---

class LLMCostSchema

---

class LLMUsageSchema

---

class ModelCreateBody

Pydantic Fields:

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

---

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

---

class ModelCreateRes

Pydantic Fields:

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

---

class ModelDeleteReq

Pydantic Fields:

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

---

class ModelDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class ModelListReq

Pydantic Fields:

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

---

class ModelReadReq

Pydantic Fields:

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

---

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

---

class ObjCreateReq

Pydantic Fields:

• obj: <class 'ObjSchemaForInsert'>

---

class ObjCreateRes

Pydantic Fields:

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

---

class ObjDeleteReq

Pydantic Fields:

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

---

class ObjDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class ObjQueryReq

Pydantic Fields:

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

---

class ObjQueryRes

Pydantic Fields:

• objs: list[ObjSchema]

---

class ObjReadReq

Pydantic Fields:

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

---

class ObjReadRes

Pydantic Fields:

• obj: <class 'ObjSchema'>

---

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

---

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

method model_post_init

model_post_init(_ObjSchemaForInsert__context: Any) → None

---

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.

---

method dataset_create

dataset_create(req: DatasetCreateReq) → DatasetCreateRes

---

method dataset_delete

dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes

---

method dataset_list

dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes]

---

method dataset_read

dataset_read(req: DatasetReadReq) → DatasetReadRes

---

method evaluation_create

evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes

---

method evaluation_delete

evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes

---

method evaluation_list

evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes]

---

method evaluation_read

evaluation_read(req: EvaluationReadReq) → EvaluationReadRes

---

method evaluation_run_create

evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes

---

method evaluation_run_delete

evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes

---

method evaluation_run_finish

evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes

---

method evaluation_run_list

evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes]

---

method evaluation_run_read

evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes

---

method model_create

model_create(req: ModelCreateReq) → ModelCreateRes

---

method model_delete

model_delete(req: ModelDeleteReq) → ModelDeleteRes

---

method model_list

model_list(req: ModelListReq) → Iterator[ModelReadRes]

---

method model_read

model_read(req: ModelReadReq) → ModelReadRes

---

method op_create

op_create(req: OpCreateReq) → OpCreateRes

---

method op_delete

op_delete(req: OpDeleteReq) → OpDeleteRes

---

method op_list

op_list(req: OpListReq) → Iterator[OpReadRes]

---

method op_read

op_read(req: OpReadReq) → OpReadRes

---

method prediction_create

prediction_create(req: PredictionCreateReq) → PredictionCreateRes

---

method prediction_delete

prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes

---

method prediction_finish

prediction_finish(req: PredictionFinishReq) → PredictionFinishRes

---

method prediction_list

prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes]

---

method prediction_read

prediction_read(req: PredictionReadReq) → PredictionReadRes

---

method score_create

score_create(req: ScoreCreateReq) → ScoreCreateRes

---

method score_delete

score_delete(req: ScoreDeleteReq) → ScoreDeleteRes

---

method score_list

score_list(req: ScoreListReq) → Iterator[ScoreReadRes]

---

method score_read

score_read(req: ScoreReadReq) → ScoreReadRes

---

method scorer_create

scorer_create(req: ScorerCreateReq) → ScorerCreateRes

---

method scorer_delete

scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes

---

method scorer_list

scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes]

---

method scorer_read

scorer_read(req: ScorerReadReq) → ScorerReadRes

---

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

---

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

---

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

---

class OpCreateRes

Response model for creating an Op object.

Pydantic Fields:

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

---

class OpDeleteReq

Pydantic Fields:

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

---

class OpDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class OpListReq

Pydantic Fields:

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

---

class OpReadReq

Pydantic Fields:

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

---

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

---

class OtelExportReq

Pydantic Fields:

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

---

class OtelExportRes

Pydantic Fields:

• partial_success: ExportTracePartialSuccess | None

---

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

---

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

---

class PredictionCreateRes

Pydantic Fields:

• prediction_id: <class 'str'>

---

class PredictionDeleteReq

Pydantic Fields:

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

---

class PredictionDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class PredictionFinishReq

Pydantic Fields:

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

---

class PredictionFinishRes

Pydantic Fields:

• success: <class 'bool'>

---

class PredictionListReq

Pydantic Fields:

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

---

class PredictionListRes

Pydantic Fields:

• predictions: list[PredictionReadRes]

---

class PredictionReadReq

Pydantic Fields:

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

---

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

---

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

---

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

---

class RefsReadBatchReq

Pydantic Fields:

• refs: list[str]

---

class RefsReadBatchRes

Pydantic Fields:

• vals: list[typing.Any]

---

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

---

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

---

class ScoreCreateRes

Pydantic Fields:

• score_id: <class 'str'>

---

class ScoreDeleteReq

Pydantic Fields:

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

---

class ScoreDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class ScoreListReq

Pydantic Fields:

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

---

class ScoreReadReq

Pydantic Fields:

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

---

class ScoreReadRes

Pydantic Fields:

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

---

class ScorerCreateBody

Pydantic Fields:

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

---

class ScorerCreateReq

Pydantic Fields:

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

---

class ScorerCreateRes

Pydantic Fields:

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

---

class ScorerDeleteReq

Pydantic Fields:

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

---

class ScorerDeleteRes

Pydantic Fields:

• num_deleted: <class 'int'>

---

class ScorerListReq

Pydantic Fields:

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

---

class ScorerReadReq

Pydantic Fields:

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

---

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

---

class SortBy

Pydantic Fields:

• field: <class 'str'>
• direction: typing.Literal['asc', 'desc']

---

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

---

class SummaryInsertMap

---

class SummaryMap

---

class TableAppendSpec

Pydantic Fields:

• append: <class 'TableAppendSpecPayload'>

---

class TableAppendSpecPayload

Pydantic Fields:

• row: dict[str, typing.Any]

---

class TableCreateFromDigestsReq

Pydantic Fields:

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

---

class TableCreateFromDigestsRes

Pydantic Fields:

• digest: <class 'str'>

---

class TableCreateReq

Pydantic Fields:

• table: <class 'TableSchemaForInsert'>

---

class TableCreateRes

Pydantic Fields:

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

---

class TableInsertSpec

Pydantic Fields:

• insert: <class 'TableInsertSpecPayload'>

---

class TableInsertSpecPayload

Pydantic Fields:

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

---

class TablePopSpec

Pydantic Fields:

• pop: <class 'TablePopSpecPayload'>

---

class TablePopSpecPayload

Pydantic Fields:

• index: <class 'int'>

---

class TableQueryReq

Pydantic Fields:

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

---

class TableQueryRes

Pydantic Fields:

• rows: list[TableRowSchema]

---

class TableQueryStatsBatchReq

Pydantic Fields:

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

---

class TableQueryStatsBatchRes

Pydantic Fields:

• tables: list[TableStatsRow]

---

class TableQueryStatsReq

Pydantic Fields:

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

---

class TableQueryStatsRes

Pydantic Fields:

• count: <class 'int'>

---

class TableRowFilter

Pydantic Fields:

• row_digests: list[str] | None

---

class TableRowSchema

Pydantic Fields:

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

---

class TableSchemaForInsert

Pydantic Fields:

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

---

class TableStatsRow

Pydantic Fields:

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

---

class TableUpdateReq

Pydantic Fields:

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

---

class TableUpdateRes

Pydantic Fields:

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

---

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

---

class ThreadsQueryFilter

Pydantic Fields:

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

---

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[SortBy] | None

---

class TraceServerInterface

---

method actions_execute_batch

actions_execute_batch(req: ActionsExecuteBatchReq) → ActionsExecuteBatchRes

---

method call_end

call_end(req: CallEndReq) → CallEndRes

---

method call_read

call_read(req: CallReadReq) → CallReadRes

---

method call_start

call_start(req: CallStartReq) → CallStartRes

---

method call_start_batch

call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes

---

method call_update

call_update(req: CallUpdateReq) → CallUpdateRes

---

method calls_delete

calls_delete(req: CallsDeleteReq) → CallsDeleteRes

---

method calls_query

calls_query(req: CallsQueryReq) → CallsQueryRes

---

method calls_query_stats

calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes

---

method calls_query_stream

calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema]

---

method completions_create

completions_create(req: CompletionsCreateReq) → CompletionsCreateRes

---

method completions_create_stream

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

---

method cost_create

cost_create(req: CostCreateReq) → CostCreateRes

---

method cost_purge

cost_purge(req: CostPurgeReq) → CostPurgeRes

---

method cost_query

cost_query(req: CostQueryReq) → CostQueryRes

---

method ensure_project_exists

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

---

method evaluate_model

evaluate_model(req: EvaluateModelReq) → EvaluateModelRes

---

method evaluation_status

evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes

---

method feedback_create

feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes

---

method feedback_create_batch

feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes

---

method feedback_purge

feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes

---

method feedback_query

feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes

---

method feedback_replace

feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes

---

method file_content_read

file_content_read(req: FileContentReadReq) → FileContentReadRes

---

method file_create

file_create(req: FileCreateReq) → FileCreateRes

---

method files_stats

files_stats(req: FilesStatsReq) → FilesStatsRes

---

method image_create

image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes

---

method obj_create

obj_create(req: ObjCreateReq) → ObjCreateRes

---

method obj_delete

obj_delete(req: ObjDeleteReq) → ObjDeleteRes

---

method obj_read

obj_read(req: ObjReadReq) → ObjReadRes

---

method objs_query

objs_query(req: ObjQueryReq) → ObjQueryRes

---

method otel_export

otel_export(req: OtelExportReq) → OtelExportRes

---

method project_stats

project_stats(req: ProjectStatsReq) → ProjectStatsRes

---

method refs_read_batch

refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes

---

method table_create

table_create(req: TableCreateReq) → TableCreateRes

---

method table_create_from_digests

table_create_from_digests(
    req: TableCreateFromDigestsReq
) → TableCreateFromDigestsRes

---

method table_query

table_query(req: TableQueryReq) → TableQueryRes

---

method table_query_stats

table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes

---

method table_query_stats_batch

table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes

---

method table_query_stream

table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema]

---

method table_update

table_update(req: TableUpdateReq) → TableUpdateRes

---

method threads_query_stream

threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema]

---

class TraceStatus

---

class WeaveSummarySchema