> ## Documentation Index > Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt > Use this file to discover all available pages before exploring further. # trace_server_interface > Python SDK reference for weave.trace_server.trace_server_interface export const SourceLink = ({url}) => Source ; # API Overview *** ## class `ActionsExecuteBatchReq` **Pydantic Fields:** * `project_id`: `` * `action_ref`: `` * `call_ids`: `list[str]` * `wb_user_id`: `str | None` *** ## class `ActionsExecuteBatchRes` *** ## class `AggregationType` Aggregation functions supported by feedback and call stats metrics. *** ## class `AliasesListReq` **Pydantic Fields:** * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `AliasesListRes` **Pydantic Fields:** * `aliases`: `list[str]` *** ## 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`: `` * `call_ids`: `list[str]` * `display_fields`: `list[str]` * `queue_id`: `` * `wb_user_id`: `str | None` *** ## class `AnnotationQueueAddCallsRes` Response from adding calls to a queue. **Pydantic Fields:** * `added_count`: `` * `duplicates`: `` *** ## class `AnnotationQueueCreateReq` Request to create a new annotation queue. **Pydantic Fields:** * `project_id`: `` * `name`: `` * `description`: `` * `scorer_refs`: `list[str]` * `wb_user_id`: `str | None` *** ## class `AnnotationQueueCreateRes` Response from creating an annotation queue. **Pydantic Fields:** * `id`: `` *** ## class `AnnotationQueueDeleteReq` Request to delete (soft-delete) an annotation queue. **Pydantic Fields:** * `project_id`: `` * `queue_id`: `` * `wb_user_id`: `str | None` *** ## class `AnnotationQueueDeleteRes` Response from deleting an annotation queue. **Pydantic Fields:** * `queue`: `` *** ## class `AnnotationQueueItemSchema` Schema for annotation queue item responses. **Pydantic Fields:** * `id`: `` * `project_id`: `` * `queue_id`: `` * `call_id`: `` * `call_started_at`: `` * `call_ended_at`: `datetime.datetime | None` * `call_op_name`: `` * `call_trace_id`: `` * `display_fields`: `list[str]` * `added_by`: `str | None` * `annotation_state`: `typing.Literal['unstarted', 'in_progress', 'completed', 'skipped']` * `annotator_user_id`: `str | None` * `created_at`: `` * `created_by`: `` * `updated_at`: `` * `deleted_at`: `datetime.datetime | None` * `position_in_queue`: `int | None` *** ## class `AnnotationQueueItemsQueryReq` Request to query items in an annotation queue. Extends AnnotationQueueItemsQueryBody by adding queue\_id for internal API usage. **Pydantic Fields:** * `project_id`: `` * `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`: `` * `queue_id`: `` *** ## class `AnnotationQueueItemsQueryRes` Response from querying annotation queue items. **Pydantic Fields:** * `items`: `list[AnnotationQueueItemSchema]` *** ## class `AnnotationQueueReadReq` Request to read a specific annotation queue. **Pydantic Fields:** * `project_id`: `` * `queue_id`: `` *** ## class `AnnotationQueueReadRes` Response from reading an annotation queue. **Pydantic Fields:** * `queue`: `` *** ## class `AnnotationQueueSchema` Schema for annotation queue responses. **Pydantic Fields:** * `id`: `` * `project_id`: `` * `name`: `` * `description`: `` * `scorer_refs`: `list[str]` * `created_at`: `` * `created_by`: `` * `updated_at`: `` * `deleted_at`: `datetime.datetime | None` *** ## class `AnnotationQueueStatsSchema` Statistics for a single annotation queue. **Pydantic Fields:** * `queue_id`: `` * `total_items`: `` * `completed_items`: `` *** ## class `AnnotationQueueUpdateReq` Request to update an annotation queue. All fields except project\_id and queue\_id are optional - only provided fields will be updated. **Pydantic Fields:** * `project_id`: `` * `queue_id`: `` * `name`: `str | None` * `description`: `str | None` * `scorer_refs`: `list[str] | None` * `wb_user_id`: `str | None` *** ## class `AnnotationQueueUpdateRes` Response from updating an annotation queue. **Pydantic Fields:** * `queue`: `` *** ## class `AnnotationQueuesQueryReq` Request to query annotation queues for a project. **Pydantic Fields:** * `project_id`: `` * `name`: `str | None` * `sort_by`: `list[weave.trace_server.common_interface.SortBy] | None` * `limit`: `int | None` * `offset`: `int | None` *** ## class `AnnotationQueuesQueryRes` Response from querying annotation queues. **Pydantic Fields:** * `queues`: `list[AnnotationQueueSchema]` *** ## class `AnnotationQueuesStatsReq` Request to get stats for multiple annotation queues. **Pydantic Fields:** * `project_id`: `` * `queue_ids`: `list[str]` *** ## class `AnnotationQueuesStatsRes` Response with stats for multiple annotation queues. **Pydantic Fields:** * `stats`: `list[AnnotationQueueStatsSchema]` *** ## 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 * same\_state -> same\_state: Idempotent no-op (returns existing item unchanged) **Pydantic Fields:** * `project_id`: `` * `queue_id`: `` * `item_id`: `` * `annotation_state`: `` * `wb_user_id`: `str | None` *** ## class `AnnotatorQueueItemsProgressUpdateRes` Response from updating annotation state. **Pydantic Fields:** * `item`: `` *** ## class `CallBatchEndMode` **Pydantic Fields:** * `mode`: `` * `req`: `` *** ## class `CallBatchStartMode` **Pydantic Fields:** * `mode`: `` * `req`: `` *** ## class `CallCreateBatchReq` **Pydantic Fields:** * `batch`: `list[CallBatchStartMode | CallBatchEndMode]` *** ## class `CallCreateBatchRes` **Pydantic Fields:** * `res`: `list[CallStartRes | CallEndRes]` *** ## class `CallEndReq` **Pydantic Fields:** * `end`: `` *** ## class `CallEndRes` *** ## class `CallEndV2Req` Request for ending a single call via v2 API. **Pydantic Fields:** * `end`: `` *** ## class `CallEndV2Res` Response for ending a single call via v2 API. *** ## class `CallMetricSpec` Specification for a call-level metric to aggregate (not grouped by model). **Pydantic Fields:** * `metric`: `typing.Literal['latency_ms', 'call_count', 'error_count']` * `aggregations`: `list[AggregationType]` * `percentiles`: `list[float]` *** ## class `CallReadReq` **Pydantic Fields:** * `project_id`: `` * `id`: `` * `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`: `` * `project_id`: `` * `op_name`: `` * `display_name`: `str | None` * `trace_id`: `` * `parent_id`: `str | None` * `thread_id`: `str | None` * `turn_id`: `str | None` * `started_at`: `` * `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` ```python theme={null} serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any] ``` *** ## class `CallStartReq` **Pydantic Fields:** * `start`: `` *** ## class `CallStartRes` **Pydantic Fields:** * `id`: `` * `trace_id`: `` *** ## class `CallStartV2Req` Request for starting a single call via v2 API. **Pydantic Fields:** * `start`: `` *** ## class `CallStartV2Res` Response for starting a single call via v2 API. **Pydantic Fields:** * `id`: `` * `trace_id`: `` *** ## class `CallStatsReq` Request for aggregated call statistics over a time range. **Pydantic Fields:** * `project_id`: `` * `start`: `` * `end`: `datetime.datetime | None` * `granularity`: `int | None` * `usage_metrics`: `list[UsageMetricSpec] | None` * `call_metrics`: `list[CallMetricSpec] | None` * `filter`: `CallsFilter | None` * `timezone`: `` ### method `validate_date_range` ```python theme={null} validate_date_range() → CallStatsReq ``` Ensure call stats requests are bounded to a safe date range. *** ## class `CallStatsRes` Response containing time-series call statistics. **Pydantic Fields:** * `start`: `` * `end`: `` * `granularity`: `` * `timezone`: `` * `usage_buckets`: `list[dict[str, typing.Any]]` * `call_buckets`: `list[dict[str, typing.Any]]` *** ## class `CallUpdateReq` **Pydantic Fields:** * `project_id`: `` * `call_id`: `` * `display_name`: `str | None` * `wb_user_id`: `str | None` *** ## class `CallUpdateRes` *** ## class `CallsDeleteReq` **Pydantic Fields:** * `project_id`: `` * `call_ids`: `list[str]` * `wb_user_id`: `str | None` *** ## class `CallsDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## 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`: `` * `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` *** ## class `CallsQueryRes` **Pydantic Fields:** * `calls`: `list[CallSchema]` *** ## class `CallsQueryStatsReq` **Pydantic Fields:** * `project_id`: `` * `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`: `` * `total_storage_size_bytes`: `int | None` *** ## class `CallsScoreReq` Request to enqueue scoring jobs for a list of calls. Scoring is performed asynchronously by the call\_scoring\_worker, which consumes messages from Kafka and applies each scorer\_ref to each call\_id. **Pydantic Fields:** * `project_id`: `` * `call_ids`: `list[str]` * `scorer_refs`: `list[str]` * `wb_user_id`: `str | None` *** ## class `CallsScoreRes` Empty response for calls\_score. Defined as a model (rather than returning None) to follow the convention used throughout this interface and to allow fields to be added later without a breaking change. *** ## class `CallsUpsertCompleteReq` Request for upserting a batch of completed calls. **Pydantic Fields:** * `batch`: `list[CompletedCallSchemaForInsert]` *** ## class `CallsUpsertCompleteRes` Response for upserting a batch of completed calls. *** ## class `CallsUsageReq` Request to compute aggregated usage for multiple root calls. This endpoint returns usage metrics for each requested root call, where each root's metrics include the sum of its own usage plus all descendants' usage. Note: All matching calls are loaded into memory for aggregation. For very large result sets (>10k calls), consider batching root call IDs or using narrower filters at the application layer. **Pydantic Fields:** * `project_id`: `` * `call_ids`: `list[str]` * `include_costs`: `` * `limit`: `` *** ## class `CallsUsageRes` Response with aggregated usage metrics per root call. **Pydantic Fields:** * `call_usage`: `dict[str, dict[str, LLMAggregatedUsage]]` * `unfinished_call_ids`: `list[str]` *** ## class `CompletedCallSchemaForInsert` Schema for inserting a completed call directly. This represents a call that is already finished at insertion time, with both start and end information provided together. Used by the calls\_complete endpoint. **Pydantic Fields:** * `project_id`: `` * `id`: `` * `trace_id`: `` * `op_name`: `` * `started_at`: `` * `ended_at`: `` * `display_name`: `str | None` * `parent_id`: `str | None` * `thread_id`: `str | None` * `turn_id`: `str | None` * `attributes`: `dict[str, typing.Any]` * `inputs`: `dict[str, typing.Any]` * `output`: `typing.Any | None` * `summary`: `` * `otel_dump`: `dict[str, typing.Any] | None` * `exception`: `str | None` * `wb_user_id`: `str | None` * `wb_run_id`: `str | None` * `wb_run_step`: `int | None` * `wb_run_step_end`: `int | None` ### method `serialize_typed_dicts` ```python theme={null} serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any] ``` *** ## class `CompletionsCreateReq` **Pydantic Fields:** * `project_id`: `` * `inputs`: `` * `wb_user_id`: `str | None` * `track_llm_call`: `bool | None` * `trace_id`: `str | None` * `parent_id`: `str | None` *** ## class `CompletionsCreateRequestInputs` **Pydantic Fields:** * `model`: `` * `messages`: `` * `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` * `vertex_credentials`: `str | None` *** ## class `CompletionsCreateRes` **Pydantic Fields:** * `response`: `dict[str, typing.Any]` * `weave_call_id`: `str | None` *** ## class `CostCreateInput` **Pydantic Fields:** * `prompt_token_cost`: `` * `completion_token_cost`: `` * `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`: `` * `costs`: `dict[str, CostCreateInput]` * `wb_user_id`: `str | None` *** ## class `CostCreateRes` **Pydantic Fields:** * `ids`: `list[tuple[str, str]]` *** ## class `CostPurgeReq` **Pydantic Fields:** * `project_id`: `` * `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`: `` * `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` *** ## 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`: `` * `wb_user_id`: `str | None` *** ## class `DatasetCreateRes` **Pydantic Fields:** * `digest`: `` * `object_id`: `` * `version_index`: `` *** ## class `DatasetDeleteReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digests`: `list[str] | None` * `wb_user_id`: `str | None` *** ## class `DatasetDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `DatasetListReq` **Pydantic Fields:** * `project_id`: `` * `limit`: `int | None` * `offset`: `int | None` * `wb_user_id`: `str | None` *** ## class `DatasetReadReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `wb_user_id`: `str | None` *** ## class `DatasetReadRes` **Pydantic Fields:** * `object_id`: `` * `digest`: `` * `version_index`: `` * `created_at`: `` * `name`: `` * `description`: `str | None` * `rows`: `` *** ## class `EndedCallSchemaForInsert` **Pydantic Fields:** * `project_id`: `` * `id`: `` * `ended_at`: `` * `exception`: `str | None` * `output`: `typing.Any | None` * `summary`: `` * `wb_run_step_end`: `int | None` ### method `serialize_typed_dicts` ```python theme={null} serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any] ``` *** ## class `EndedCallSchemaForInsertWithStartedAt` Ended call schema with optional started\_at for v2 end updates. When started\_at is provided, it enables more efficient ClickHouse queries by utilizing the primary key (project\_id, started\_at, id). Without it, the query falls back to using only (project\_id, id). **Pydantic Fields:** * `project_id`: `` * `id`: `` * `ended_at`: `` * `exception`: `str | None` * `output`: `typing.Any | None` * `summary`: `` * `wb_run_step_end`: `int | None` * `started_at`: `datetime.datetime | None` ### method `serialize_typed_dicts` ```python theme={null} serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any] ``` *** ## class `EvalResultsEvaluationSummary` **Pydantic Fields:** * `evaluation_call_id`: `` * `trial_count`: `` * `scorer_stats`: `list[EvalResultsScorerStats]` * `evaluation_ref`: `str | None` * `model_ref`: `str | None` * `display_name`: `str | None` * `trace_id`: `str | None` * `started_at`: `str | None` *** ## class `EvalResultsQueryBody` **Pydantic Fields:** * `evaluation_call_ids`: `list[str] | None` * `evaluation_run_ids`: `list[str] | None` * `require_intersection`: `` * `include_raw_data_rows`: `` * `resolve_row_refs`: `` * `include_rows`: `` * `include_summary`: `` * `summary_require_intersection`: `bool | None` * `limit`: `int | None` * `offset`: `` ### method `validate_identifiers` ```python theme={null} validate_identifiers() → EvalResultsQueryBody ``` Validate that at least one evaluation identifier is provided. *** ## class `EvalResultsQueryReq` **Pydantic Fields:** * `evaluation_call_ids`: `list[str] | None` * `evaluation_run_ids`: `list[str] | None` * `require_intersection`: `` * `include_raw_data_rows`: `` * `resolve_row_refs`: `` * `include_rows`: `` * `include_summary`: `` * `summary_require_intersection`: `bool | None` * `limit`: `int | None` * `offset`: `` * `project_id`: `` ### method `validate_identifiers` ```python theme={null} validate_identifiers() → EvalResultsQueryBody ``` Validate that at least one evaluation identifier is provided. *** ## class `EvalResultsQueryRes` **Pydantic Fields:** * `rows`: `list[EvalResultsRow]` * `total_rows`: `` * `summary`: `ForwardRef('EvalResultsSummaryRes | None')` * `warnings`: `list[str]` *** ## class `EvalResultsRow` **Pydantic Fields:** * `row_digest`: `` * `raw_data_row`: `typing.Any | None` * `evaluations`: `list[EvalResultsRowEvaluation]` *** ## class `EvalResultsRowEvaluation` **Pydantic Fields:** * `evaluation_call_id`: `` * `trials`: `list[EvalResultsTrial]` *** ## class `EvalResultsScorerStats` Stats for a single flattened score dimension (scorer\_key or scorer\_key.path.to.leaf). **Pydantic Fields:** * `scorer_key`: `` * `path`: `str | None` * `value_type`: `typing.Optional[typing.Literal['binary', 'continuous']]` * `trial_count`: `` * `numeric_count`: `` * `numeric_mean`: `float | None` * `pass_true_count`: `` * `pass_known_count`: `` * `pass_rate`: `float | None` * `pass_signal_coverage`: `float | None` *** ## class `EvalResultsSummaryRes` **Pydantic Fields:** * `row_count`: `` * `evaluations`: `list[EvalResultsEvaluationSummary]` *** ## class `EvalResultsTrial` **Pydantic Fields:** * `predict_and_score_call_id`: `` * `predict_call_id`: `str | None` * `model_output`: `typing.Any | None` * `scores`: `dict[str, typing.Any]` * `model_latency_seconds`: `float | None` * `total_tokens`: `int | None` * `scorer_call_ids`: `dict[str, str]` *** ## class `EvaluateModelReq` **Pydantic Fields:** * `project_id`: `` * `evaluation_ref`: `` * `model_ref`: `` * `wb_user_id`: `str | None` *** ## class `EvaluateModelRes` **Pydantic Fields:** * `call_id`: `` *** ## class `EvaluationCreateBody` **Pydantic Fields:** * `name`: `` * `description`: `str | None` * `dataset`: `` * `scorers`: `list[str] | None` * `trials`: `` * `evaluation_name`: `str | None` * `eval_attributes`: `dict[str, typing.Any] | None` *** ## class `EvaluationCreateReq` **Pydantic Fields:** * `name`: `` * `description`: `str | None` * `dataset`: `` * `scorers`: `list[str] | None` * `trials`: `` * `evaluation_name`: `str | None` * `eval_attributes`: `dict[str, typing.Any] | None` * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `EvaluationCreateRes` **Pydantic Fields:** * `digest`: `` * `object_id`: `` * `version_index`: `` * `evaluation_ref`: `` *** ## class `EvaluationDeleteReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digests`: `list[str] | None` * `wb_user_id`: `str | None` *** ## class `EvaluationDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `EvaluationListReq` **Pydantic Fields:** * `project_id`: `` * `limit`: `int | None` * `offset`: `int | None` * `wb_user_id`: `str | None` *** ## class `EvaluationReadReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `wb_user_id`: `str | None` *** ## class `EvaluationReadRes` **Pydantic Fields:** * `object_id`: `` * `digest`: `` * `version_index`: `` * `created_at`: `` * `name`: `` * `description`: `str | None` * `dataset`: `` * `scorers`: `list[str]` * `trials`: `` * `evaluation_name`: `str | None` * `evaluate_op`: `str | None` * `predict_and_score_op`: `str | None` * `summarize_op`: `str | None` *** ## class `EvaluationRunCreateBody` **Pydantic Fields:** * `evaluation`: `` * `model`: `` *** ## class `EvaluationRunCreateReq` **Pydantic Fields:** * `evaluation`: `` * `model`: `` * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `EvaluationRunCreateRes` **Pydantic Fields:** * `evaluation_run_id`: `` *** ## class `EvaluationRunDeleteReq` **Pydantic Fields:** * `project_id`: `` * `evaluation_run_ids`: `list[str]` * `wb_user_id`: `str | None` *** ## class `EvaluationRunDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## 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`: `` * `evaluation_run_id`: `` * `wb_user_id`: `str | None` *** ## class `EvaluationRunFinishRes` **Pydantic Fields:** * `success`: `` *** ## class `EvaluationRunListReq` **Pydantic Fields:** * `project_id`: `` * `filter`: `EvaluationRunFilter | None` * `limit`: `int | None` * `offset`: `int | None` *** ## class `EvaluationRunReadReq` **Pydantic Fields:** * `project_id`: `` * `evaluation_run_id`: `` *** ## class `EvaluationRunReadRes` **Pydantic Fields:** * `evaluation_run_id`: `` * `evaluation`: `` * `model`: `` * `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`: `` * `call_id`: `` *** ## class `EvaluationStatusRes` **Pydantic Fields:** * `status`: `EvaluationStatusNotFound | EvaluationStatusRunning | EvaluationStatusFailed | EvaluationStatusComplete` *** ## class `EvaluationStatusRunning` **Pydantic Fields:** * `code`: `typing.Literal['running']` * `completed_rows`: `` * `total_rows`: `` *** ## class `ExportTracePartialSuccess` **Pydantic Fields:** * `rejected_spans`: `` * `error_message`: `` *** ## class `ExtraKeysTypedDict` *** ## class `Feedback` **Pydantic Fields:** * `id`: `` * `project_id`: `` * `weave_ref`: `` * `creator`: `str | None` * `feedback_type`: `` * `payload`: `dict[str, typing.Any]` * `annotation_ref`: `str | None` * `runnable_ref`: `str | None` * `call_ref`: `str | None` * `trigger_ref`: `str | None` * `queue_id`: `str | None` * `wb_user_id`: `str | None` * `created_at`: `` *** ## class `FeedbackCreateBatchReq` **Pydantic Fields:** * `batch`: `list[FeedbackCreateReq]` *** ## class `FeedbackCreateBatchRes` **Pydantic Fields:** * `res`: `list[FeedbackCreateRes]` *** ## class `FeedbackCreateReq` **Pydantic Fields:** * `id`: `str | None` * `project_id`: `` * `weave_ref`: `` * `creator`: `str | None` * `feedback_type`: `` * `payload`: `dict[str, typing.Any]` * `annotation_ref`: `str | None` * `runnable_ref`: `str | None` * `call_ref`: `str | None` * `trigger_ref`: `str | None` * `queue_id`: `str | None` * `wb_user_id`: `str | None` *** ## class `FeedbackCreateRes` **Pydantic Fields:** * `id`: `` * `created_at`: `` * `wb_user_id`: `` * `payload`: `dict[str, typing.Any]` *** ## class `FeedbackDict` *** ## class `FeedbackMetricSpec` Specification for a feedback payload metric to aggregate. **Pydantic Fields:** * `json_path`: `` * `value_type`: `typing.Literal['numeric', 'boolean', 'categorical']` * `aggregations`: `list[AggregationType]` * `percentiles`: `list[float]` *** ## class `FeedbackPayloadPath` Discovered path in feedback payload with inferred type. **Pydantic Fields:** * `json_path`: `` * `value_type`: `typing.Literal['numeric', 'boolean', 'categorical']` *** ## class `FeedbackPayloadSchemaReq` Request for feedback payload schema discovery. **Pydantic Fields:** * `project_id`: `` * `start`: `` * `end`: `datetime.datetime | None` * `feedback_type`: `str | None` * `trigger_ref`: `str | None` * `sample_limit`: `` ### method `validate_date_range` ```python theme={null} validate_date_range() → _FeedbackFilterBase ``` Ensure feedback requests are bounded to a safe date range. *** ## class `FeedbackPayloadSchemaRes` Response with discovered feedback payload paths and types. **Pydantic Fields:** * `paths`: `list[FeedbackPayloadPath]` *** ## class `FeedbackPurgeReq` **Pydantic Fields:** * `project_id`: `` * `query`: `` *** ## class `FeedbackPurgeRes` *** ## class `FeedbackQueryReq` **Pydantic Fields:** * `project_id`: `` * `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` *** ## class `FeedbackQueryRes` **Pydantic Fields:** * `result`: `list[dict[str, typing.Any]]` *** ## class `FeedbackReplaceReq` **Pydantic Fields:** * `id`: `str | None` * `project_id`: `` * `weave_ref`: `` * `creator`: `str | None` * `feedback_type`: `` * `payload`: `dict[str, typing.Any]` * `annotation_ref`: `str | None` * `runnable_ref`: `str | None` * `call_ref`: `str | None` * `trigger_ref`: `str | None` * `queue_id`: `str | None` * `wb_user_id`: `str | None` * `feedback_id`: `` *** ## class `FeedbackReplaceRes` **Pydantic Fields:** * `id`: `` * `created_at`: `` * `wb_user_id`: `` * `payload`: `dict[str, typing.Any]` *** ## class `FeedbackStatsReq` Request for aggregated feedback statistics over time buckets. **Pydantic Fields:** * `project_id`: `` * `start`: `` * `end`: `datetime.datetime | None` * `feedback_type`: `str | None` * `trigger_ref`: `str | None` * `granularity`: `int | None` * `timezone`: `` * `metrics`: `list[FeedbackMetricSpec]` ### method `validate_date_range` ```python theme={null} validate_date_range() → _FeedbackFilterBase ``` Ensure feedback requests are bounded to a safe date range. *** ## class `FeedbackStatsRes` Response with time-series feedback statistics. **Pydantic Fields:** * `start`: `` * `end`: `` * `granularity`: `` * `timezone`: `` * `buckets`: `list[dict[str, typing.Any]]` * `window_stats`: `dict[str, dict[str, float | None]] | None` *** ## class `FileContentReadReq` **Pydantic Fields:** * `project_id`: `` * `digest`: `` *** ## class `FileContentReadRes` **Pydantic Fields:** * `content`: `` *** ## class `FileCreateReq` **Pydantic Fields:** * `project_id`: `` * `name`: `` * `content`: `` * `expected_digest`: `str | None` *** ## class `FileCreateRes` **Pydantic Fields:** * `digest`: `` *** ## class `FilesStatsReq` **Pydantic Fields:** * `project_id`: `` *** ## class `FilesStatsRes` **Pydantic Fields:** * `total_size_bytes`: `` *** ## 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` ```python theme={null} actions_execute_batch(req: ActionsExecuteBatchReq) → ActionsExecuteBatchRes ``` *** ### method `aliases_list` ```python theme={null} aliases_list(req: AliasesListReq) → AliasesListRes ``` *** ### method `annotation_queue_add_calls` ```python theme={null} annotation_queue_add_calls( req: AnnotationQueueAddCallsReq ) → AnnotationQueueAddCallsRes ``` *** ### method `annotation_queue_create` ```python theme={null} annotation_queue_create( req: AnnotationQueueCreateReq ) → AnnotationQueueCreateRes ``` *** ### method `annotation_queue_delete` ```python theme={null} annotation_queue_delete( req: AnnotationQueueDeleteReq ) → AnnotationQueueDeleteRes ``` *** ### method `annotation_queue_items_query` ```python theme={null} annotation_queue_items_query( req: AnnotationQueueItemsQueryReq ) → AnnotationQueueItemsQueryRes ``` *** ### method `annotation_queue_read` ```python theme={null} annotation_queue_read(req: AnnotationQueueReadReq) → AnnotationQueueReadRes ``` *** ### method `annotation_queue_update` ```python theme={null} annotation_queue_update( req: AnnotationQueueUpdateReq ) → AnnotationQueueUpdateRes ``` *** ### method `annotation_queues_query_stream` ```python theme={null} annotation_queues_query_stream( req: AnnotationQueuesQueryReq ) → Iterator[AnnotationQueueSchema] ``` *** ### method `annotation_queues_stats` ```python theme={null} annotation_queues_stats( req: AnnotationQueuesStatsReq ) → AnnotationQueuesStatsRes ``` *** ### method `annotator_queue_items_progress_update` ```python theme={null} annotator_queue_items_progress_update( req: AnnotatorQueueItemsProgressUpdateReq ) → AnnotatorQueueItemsProgressUpdateRes ``` *** ### method `call_end` ```python theme={null} call_end(req: CallEndReq) → CallEndRes ``` *** ### method `call_end_v2` ```python theme={null} call_end_v2(req: CallEndV2Req) → CallEndV2Res ``` *** ### method `call_read` ```python theme={null} call_read(req: CallReadReq) → CallReadRes ``` *** ### method `call_start` ```python theme={null} call_start(req: CallStartReq) → CallStartRes ``` *** ### method `call_start_batch` ```python theme={null} call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes ``` *** ### method `call_start_v2` ```python theme={null} call_start_v2(req: CallStartV2Req) → CallStartV2Res ``` *** ### method `call_stats` ```python theme={null} call_stats(req: 'CallStatsReq') → CallStatsRes ``` *** ### method `call_update` ```python theme={null} call_update(req: CallUpdateReq) → CallUpdateRes ``` *** ### method `calls_complete` ```python theme={null} calls_complete(req: CallsUpsertCompleteReq) → CallsUpsertCompleteRes ``` *** ### method `calls_delete` ```python theme={null} calls_delete(req: CallsDeleteReq) → CallsDeleteRes ``` *** ### method `calls_query` ```python theme={null} calls_query(req: CallsQueryReq) → CallsQueryRes ``` *** ### method `calls_query_stats` ```python theme={null} calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes ``` *** ### method `calls_query_stream` ```python theme={null} calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema] ``` *** ### method `calls_score` ```python theme={null} calls_score(req: CallsScoreReq) → CallsScoreRes ``` *** ### method `calls_usage` ```python theme={null} calls_usage(req: 'CallsUsageReq') → CallsUsageRes ``` *** ### method `completions_create` ```python theme={null} completions_create(req: CompletionsCreateReq) → CompletionsCreateRes ``` *** ### method `completions_create_stream` ```python theme={null} completions_create_stream(req: CompletionsCreateReq) → Iterator[dict[str, Any]] ``` *** ### method `cost_create` ```python theme={null} cost_create(req: CostCreateReq) → CostCreateRes ``` *** ### method `cost_purge` ```python theme={null} cost_purge(req: CostPurgeReq) → CostPurgeRes ``` *** ### method `cost_query` ```python theme={null} cost_query(req: CostQueryReq) → CostQueryRes ``` *** ### method `dataset_create` ```python theme={null} dataset_create(req: DatasetCreateReq) → DatasetCreateRes ``` *** ### method `dataset_delete` ```python theme={null} dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes ``` *** ### method `dataset_list` ```python theme={null} dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes] ``` *** ### method `dataset_read` ```python theme={null} dataset_read(req: DatasetReadReq) → DatasetReadRes ``` *** ### method `eval_results_query` ```python theme={null} eval_results_query(req: EvalResultsQueryReq) → EvalResultsQueryRes ``` *** ### method `evaluate_model` ```python theme={null} evaluate_model(req: EvaluateModelReq) → EvaluateModelRes ``` *** ### method `evaluation_create` ```python theme={null} evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes ``` *** ### method `evaluation_delete` ```python theme={null} evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes ``` *** ### method `evaluation_list` ```python theme={null} evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes] ``` *** ### method `evaluation_read` ```python theme={null} evaluation_read(req: EvaluationReadReq) → EvaluationReadRes ``` *** ### method `evaluation_run_create` ```python theme={null} evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes ``` *** ### method `evaluation_run_delete` ```python theme={null} evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes ``` *** ### method `evaluation_run_finish` ```python theme={null} evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes ``` *** ### method `evaluation_run_list` ```python theme={null} evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes] ``` *** ### method `evaluation_run_read` ```python theme={null} evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes ``` *** ### method `evaluation_status` ```python theme={null} evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes ``` *** ### method `feedback_create` ```python theme={null} feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes ``` *** ### method `feedback_create_batch` ```python theme={null} feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes ``` *** ### method `feedback_payload_schema` ```python theme={null} feedback_payload_schema( req: FeedbackPayloadSchemaReq ) → FeedbackPayloadSchemaRes ``` *** ### method `feedback_purge` ```python theme={null} feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes ``` *** ### method `feedback_query` ```python theme={null} feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes ``` *** ### method `feedback_replace` ```python theme={null} feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes ``` *** ### method `feedback_stats` ```python theme={null} feedback_stats(req: FeedbackStatsReq) → FeedbackStatsRes ``` *** ### method `file_content_read` ```python theme={null} file_content_read(req: FileContentReadReq) → FileContentReadRes ``` *** ### method `file_create` ```python theme={null} file_create(req: FileCreateReq) → FileCreateRes ``` *** ### method `files_stats` ```python theme={null} files_stats(req: FilesStatsReq) → FilesStatsRes ``` *** ### method `image_create` ```python theme={null} image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes ``` *** ### method `model_create` ```python theme={null} model_create(req: ModelCreateReq) → ModelCreateRes ``` *** ### method `model_delete` ```python theme={null} model_delete(req: ModelDeleteReq) → ModelDeleteRes ``` *** ### method `model_list` ```python theme={null} model_list(req: ModelListReq) → Iterator[ModelReadRes] ``` *** ### method `model_read` ```python theme={null} model_read(req: ModelReadReq) → ModelReadRes ``` *** ### method `obj_add_tags` ```python theme={null} obj_add_tags(req: ObjAddTagsReq) → ObjAddTagsRes ``` *** ### method `obj_create` ```python theme={null} obj_create(req: ObjCreateReq) → ObjCreateRes ``` *** ### method `obj_delete` ```python theme={null} obj_delete(req: ObjDeleteReq) → ObjDeleteRes ``` *** ### method `obj_read` ```python theme={null} obj_read(req: ObjReadReq) → ObjReadRes ``` *** ### method `obj_remove_aliases` ```python theme={null} obj_remove_aliases(req: ObjRemoveAliasesReq) → ObjRemoveAliasesRes ``` *** ### method `obj_remove_tags` ```python theme={null} obj_remove_tags(req: ObjRemoveTagsReq) → ObjRemoveTagsRes ``` *** ### method `obj_set_aliases` ```python theme={null} obj_set_aliases(req: ObjSetAliasesReq) → ObjSetAliasesRes ``` *** ### method `objs_query` ```python theme={null} objs_query(req: ObjQueryReq) → ObjQueryRes ``` *** ### method `op_create` ```python theme={null} op_create(req: OpCreateReq) → OpCreateRes ``` *** ### method `op_delete` ```python theme={null} op_delete(req: OpDeleteReq) → OpDeleteRes ``` *** ### method `op_list` ```python theme={null} op_list(req: OpListReq) → Iterator[OpReadRes] ``` *** ### method `op_read` ```python theme={null} op_read(req: OpReadReq) → OpReadRes ``` *** ### method `otel_export` ```python theme={null} otel_export(req: OTelExportReq) → OTelExportRes ``` *** ### method `prediction_create` ```python theme={null} prediction_create(req: PredictionCreateReq) → PredictionCreateRes ``` *** ### method `prediction_delete` ```python theme={null} prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes ``` *** ### method `prediction_finish` ```python theme={null} prediction_finish(req: PredictionFinishReq) → PredictionFinishRes ``` *** ### method `prediction_list` ```python theme={null} prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes] ``` *** ### method `prediction_read` ```python theme={null} prediction_read(req: PredictionReadReq) → PredictionReadRes ``` *** ### method `project_stats` ```python theme={null} project_stats(req: ProjectStatsReq) → ProjectStatsRes ``` *** ### method `refs_read_batch` ```python theme={null} refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes ``` *** ### method `score_create` ```python theme={null} score_create(req: ScoreCreateReq) → ScoreCreateRes ``` *** ### method `score_delete` ```python theme={null} score_delete(req: ScoreDeleteReq) → ScoreDeleteRes ``` *** ### method `score_list` ```python theme={null} score_list(req: ScoreListReq) → Iterator[ScoreReadRes] ``` *** ### method `score_read` ```python theme={null} score_read(req: ScoreReadReq) → ScoreReadRes ``` *** ### method `scorer_create` ```python theme={null} scorer_create(req: ScorerCreateReq) → ScorerCreateRes ``` *** ### method `scorer_delete` ```python theme={null} scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes ``` *** ### method `scorer_list` ```python theme={null} scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes] ``` *** ### method `scorer_read` ```python theme={null} scorer_read(req: ScorerReadReq) → ScorerReadRes ``` *** ### method `table_create` ```python theme={null} table_create(req: TableCreateReq) → TableCreateRes ``` *** ### method `table_create_from_digests` ```python theme={null} table_create_from_digests( req: TableCreateFromDigestsReq ) → TableCreateFromDigestsRes ``` *** ### method `table_query` ```python theme={null} table_query(req: TableQueryReq) → TableQueryRes ``` *** ### method `table_query_stats` ```python theme={null} table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes ``` *** ### method `table_query_stats_batch` ```python theme={null} table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes ``` *** ### method `table_query_stream` ```python theme={null} table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema] ``` *** ### method `table_update` ```python theme={null} table_update(req: TableUpdateReq) → TableUpdateRes ``` *** ### method `tags_list` ```python theme={null} tags_list(req: TagsListReq) → TagsListRes ``` *** ### method `threads_query_stream` ```python theme={null} threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema] ``` *** ### method `trace_usage` ```python theme={null} trace_usage(req: 'TraceUsageReq') → TraceUsageRes ``` *** ## class `ImageGenerationCreateReq` **Pydantic Fields:** * `project_id`: `` * `inputs`: `` * `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`: `` * `prompt`: `` * `n`: `int | None` *** ## class `LLMAggregatedUsage` Aggregated usage metrics for a specific LLM. **Pydantic Fields:** * `requests`: `` * `prompt_tokens`: `` * `completion_tokens`: `` * `total_tokens`: `` * `prompt_tokens_total_cost`: `float | None` * `completion_tokens_total_cost`: `float | None` *** ## class `LLMCostSchema` *** ## class `LLMUsageSchema` *** ## class `ModelCreateBody` **Pydantic Fields:** * `name`: `` * `description`: `str | None` * `source_code`: `` * `attributes`: `dict[str, typing.Any] | None` *** ## class `ModelCreateReq` **Pydantic Fields:** * `name`: `` * `description`: `str | None` * `source_code`: `` * `attributes`: `dict[str, typing.Any] | None` * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `ModelCreateRes` **Pydantic Fields:** * `digest`: `` * `object_id`: `` * `version_index`: `` * `model_ref`: `` *** ## class `ModelDeleteReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digests`: `list[str] | None` * `wb_user_id`: `str | None` *** ## class `ModelDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `ModelListReq` **Pydantic Fields:** * `project_id`: `` * `limit`: `int | None` * `offset`: `int | None` *** ## class `ModelReadReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` *** ## class `ModelReadRes` **Pydantic Fields:** * `object_id`: `` * `digest`: `` * `version_index`: `` * `created_at`: `` * `name`: `` * `description`: `str | None` * `source_code`: `` * `attributes`: `dict[str, typing.Any] | None` *** ## class `OTelExportReq` **Pydantic Fields:** * `processed_spans`: `list[ProcessedResourceSpans]` * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `OTelExportRes` **Pydantic Fields:** * `partial_success`: `ExportTracePartialSuccess | None` *** ## class `ObjAddTagsReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `tags`: `list[str]` * `wb_user_id`: `str | None` ### method `validate_tags` ```python theme={null} validate_tags() → ObjAddTagsReq ``` *** ## class `ObjAddTagsRes` *** ## class `ObjCreateReq` **Pydantic Fields:** * `obj`: `` *** ## class `ObjCreateRes` **Pydantic Fields:** * `digest`: `` * `object_id`: `str | None` *** ## class `ObjDeleteReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digests`: `list[str] | None` *** ## class `ObjDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `ObjQueryReq` **Pydantic Fields:** * `project_id`: `` * `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` * `include_tags_and_aliases`: `bool | None` *** ## class `ObjQueryRes` **Pydantic Fields:** * `objs`: `list[ObjSchema]` *** ## class `ObjReadReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `metadata_only`: `bool | None` * `include_tags_and_aliases`: `bool | None` *** ## class `ObjReadRes` **Pydantic Fields:** * `obj`: `` *** ## class `ObjRemoveAliasesReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `aliases`: `list[str]` * `wb_user_id`: `str | None` ### method `validate_aliases` ```python theme={null} validate_aliases() → ObjRemoveAliasesReq ``` *** ## class `ObjRemoveAliasesRes` *** ## class `ObjRemoveTagsReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `tags`: `list[str]` * `wb_user_id`: `str | None` *** ## class `ObjRemoveTagsRes` *** ## class `ObjSchema` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `created_at`: `` * `deleted_at`: `datetime.datetime | None` * `digest`: `` * `version_index`: `` * `is_latest`: `` * `kind`: `` * `base_object_class`: `str | None` * `leaf_object_class`: `str | None` * `val`: `typing.Any` * `wb_user_id`: `str | None` * `size_bytes`: `int | None` * `tags`: `list[str] | None` * `aliases`: `list[str] | None` *** ## class `ObjSchemaForInsert` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `val`: `typing.Any` * `builtin_object_class`: `str | None` * `set_base_object_class`: `str | None` * `expected_digest`: `str | None` * `wb_user_id`: `str | None` ### method `model_post_init` ```python theme={null} model_post_init(_ObjSchemaForInsert__context: Any) → None ``` *** ## class `ObjSetAliasesReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `aliases`: `list[str]` * `wb_user_id`: `str | None` ### method `validate_aliases` ```python theme={null} validate_aliases() → ObjSetAliasesReq ``` *** ## class `ObjSetAliasesRes` *** ## 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 `call_end_v2` ```python theme={null} call_end_v2(req: CallEndV2Req) → CallEndV2Res ``` *** ### method `call_start_v2` ```python theme={null} call_start_v2(req: CallStartV2Req) → CallStartV2Res ``` *** ### method `calls_complete` ```python theme={null} calls_complete(req: CallsUpsertCompleteReq) → CallsUpsertCompleteRes ``` *** ### method `dataset_create` ```python theme={null} dataset_create(req: DatasetCreateReq) → DatasetCreateRes ``` *** ### method `dataset_delete` ```python theme={null} dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes ``` *** ### method `dataset_list` ```python theme={null} dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes] ``` *** ### method `dataset_read` ```python theme={null} dataset_read(req: DatasetReadReq) → DatasetReadRes ``` *** ### method `eval_results_query` ```python theme={null} eval_results_query(req: EvalResultsQueryReq) → EvalResultsQueryRes ``` *** ### method `evaluation_create` ```python theme={null} evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes ``` *** ### method `evaluation_delete` ```python theme={null} evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes ``` *** ### method `evaluation_list` ```python theme={null} evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes] ``` *** ### method `evaluation_read` ```python theme={null} evaluation_read(req: EvaluationReadReq) → EvaluationReadRes ``` *** ### method `evaluation_run_create` ```python theme={null} evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes ``` *** ### method `evaluation_run_delete` ```python theme={null} evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes ``` *** ### method `evaluation_run_finish` ```python theme={null} evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes ``` *** ### method `evaluation_run_list` ```python theme={null} evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes] ``` *** ### method `evaluation_run_read` ```python theme={null} evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes ``` *** ### method `model_create` ```python theme={null} model_create(req: ModelCreateReq) → ModelCreateRes ``` *** ### method `model_delete` ```python theme={null} model_delete(req: ModelDeleteReq) → ModelDeleteRes ``` *** ### method `model_list` ```python theme={null} model_list(req: ModelListReq) → Iterator[ModelReadRes] ``` *** ### method `model_read` ```python theme={null} model_read(req: ModelReadReq) → ModelReadRes ``` *** ### method `op_create` ```python theme={null} op_create(req: OpCreateReq) → OpCreateRes ``` *** ### method `op_delete` ```python theme={null} op_delete(req: OpDeleteReq) → OpDeleteRes ``` *** ### method `op_list` ```python theme={null} op_list(req: OpListReq) → Iterator[OpReadRes] ``` *** ### method `op_read` ```python theme={null} op_read(req: OpReadReq) → OpReadRes ``` *** ### method `prediction_create` ```python theme={null} prediction_create(req: PredictionCreateReq) → PredictionCreateRes ``` *** ### method `prediction_delete` ```python theme={null} prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes ``` *** ### method `prediction_finish` ```python theme={null} prediction_finish(req: PredictionFinishReq) → PredictionFinishRes ``` *** ### method `prediction_list` ```python theme={null} prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes] ``` *** ### method `prediction_read` ```python theme={null} prediction_read(req: PredictionReadReq) → PredictionReadRes ``` *** ### method `score_create` ```python theme={null} score_create(req: ScoreCreateReq) → ScoreCreateRes ``` *** ### method `score_delete` ```python theme={null} score_delete(req: ScoreDeleteReq) → ScoreDeleteRes ``` *** ### method `score_list` ```python theme={null} score_list(req: ScoreListReq) → Iterator[ScoreReadRes] ``` *** ### method `score_read` ```python theme={null} score_read(req: ScoreReadReq) → ScoreReadRes ``` *** ### method `scorer_create` ```python theme={null} scorer_create(req: ScorerCreateReq) → ScorerCreateRes ``` *** ### method `scorer_delete` ```python theme={null} scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes ``` *** ### method `scorer_list` ```python theme={null} scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes] ``` *** ### method `scorer_read` ```python theme={null} 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` * `tags`: `list[str] | None` * `aliases`: `list[str] | 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`: `` * `wb_user_id`: `str | None` *** ## class `OpCreateRes` Response model for creating an Op object. **Pydantic Fields:** * `digest`: `` * `object_id`: `` * `version_index`: `` *** ## class `OpDeleteReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digests`: `list[str] | None` * `wb_user_id`: `str | None` *** ## class `OpDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `OpListReq` **Pydantic Fields:** * `project_id`: `` * `limit`: `int | None` * `offset`: `int | None` * `wb_user_id`: `str | None` *** ## class `OpReadReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `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`: `` * `digest`: `` * `version_index`: `` * `created_at`: `` * `code`: `` *** ## 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`: `` * `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`: `` * `inputs`: `dict[str, typing.Any]` * `output`: `typing.Any` * `evaluation_run_id`: `str | None` * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `PredictionCreateRes` **Pydantic Fields:** * `prediction_id`: `` *** ## class `PredictionDeleteReq` **Pydantic Fields:** * `project_id`: `` * `prediction_ids`: `list[str]` * `wb_user_id`: `str | None` *** ## class `PredictionDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `PredictionFinishReq` **Pydantic Fields:** * `project_id`: `` * `prediction_id`: `` * `wb_user_id`: `str | None` *** ## class `PredictionFinishRes` **Pydantic Fields:** * `success`: `` *** ## class `PredictionListReq` **Pydantic Fields:** * `project_id`: `` * `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`: `` * `prediction_id`: `` * `wb_user_id`: `str | None` *** ## class `PredictionReadRes` **Pydantic Fields:** * `prediction_id`: `` * `model`: `` * `inputs`: `dict[str, typing.Any]` * `output`: `typing.Any` * `evaluation_run_id`: `str | None` * `wb_user_id`: `str | None` *** ## class `ProcessedResourceSpans` **Pydantic Fields:** * `entity`: `` * `project`: `` * `run_id`: `str | None` * `resource_spans`: `typing.Any` *** ## class `ProjectStatsReq` **Pydantic Fields:** * `project_id`: `` * `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`: `` * `objects_storage_size_bytes`: `` * `tables_storage_size_bytes`: `` * `files_storage_size_bytes`: `` *** ## 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`: `` * `scorer`: `` * `value`: `` * `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`: `` * `scorer`: `` * `value`: `` * `evaluation_run_id`: `str | None` * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `ScoreCreateRes` **Pydantic Fields:** * `score_id`: `` *** ## class `ScoreDeleteReq` **Pydantic Fields:** * `project_id`: `` * `score_ids`: `list[str]` * `wb_user_id`: `str | None` *** ## class `ScoreDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `ScoreListReq` **Pydantic Fields:** * `project_id`: `` * `evaluation_run_id`: `str | None` * `limit`: `int | None` * `offset`: `int | None` * `wb_user_id`: `str | None` *** ## class `ScoreReadReq` **Pydantic Fields:** * `project_id`: `` * `score_id`: `` * `wb_user_id`: `str | None` *** ## class `ScoreReadRes` **Pydantic Fields:** * `score_id`: `` * `scorer`: `` * `value`: `` * `evaluation_run_id`: `str | None` * `wb_user_id`: `str | None` *** ## class `ScorerCreateBody` **Pydantic Fields:** * `name`: `` * `description`: `str | None` * `op_source_code`: `` *** ## class `ScorerCreateReq` **Pydantic Fields:** * `name`: `` * `description`: `str | None` * `op_source_code`: `` * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `ScorerCreateRes` **Pydantic Fields:** * `digest`: `` * `object_id`: `` * `version_index`: `` * `scorer`: `` *** ## class `ScorerDeleteReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digests`: `list[str] | None` * `wb_user_id`: `str | None` *** ## class `ScorerDeleteRes` **Pydantic Fields:** * `num_deleted`: `` *** ## class `ScorerListReq` **Pydantic Fields:** * `project_id`: `` * `limit`: `int | None` * `offset`: `int | None` * `wb_user_id`: `str | None` *** ## class `ScorerReadReq` **Pydantic Fields:** * `project_id`: `` * `object_id`: `` * `digest`: `` * `wb_user_id`: `str | None` *** ## class `ScorerReadRes` **Pydantic Fields:** * `object_id`: `` * `digest`: `` * `version_index`: `` * `created_at`: `` * `name`: `` * `description`: `str | None` * `score_op`: `` *** ## class `StartedCallSchemaForInsert` **Pydantic Fields:** * `project_id`: `` * `id`: `str | None` * `op_name`: `` * `display_name`: `str | None` * `trace_id`: `str | None` * `parent_id`: `str | None` * `thread_id`: `str | None` * `turn_id`: `str | None` * `started_at`: `` * `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` **Pydantic Fields:** * `row`: `dict[str, typing.Any]` *** ## class `TableCreateFromDigestsReq` **Pydantic Fields:** * `project_id`: `` * `row_digests`: `list[str]` * `expected_digest`: `str | None` *** ## class `TableCreateFromDigestsRes` **Pydantic Fields:** * `digest`: `` *** ## class `TableCreateReq` **Pydantic Fields:** * `table`: `` *** ## class `TableCreateRes` **Pydantic Fields:** * `digest`: `` * `row_digests`: `list[str]` *** ## class `TableInsertSpec` **Pydantic Fields:** * `insert`: `` *** ## class `TableInsertSpecPayload` **Pydantic Fields:** * `index`: `` * `row`: `dict[str, typing.Any]` *** ## class `TablePopSpec` **Pydantic Fields:** * `pop`: `` *** ## class `TablePopSpecPayload` **Pydantic Fields:** * `index`: `` *** ## class `TableQueryReq` **Pydantic Fields:** * `project_id`: `` * `digest`: `` * `filter`: `TableRowFilter | None` * `limit`: `int | None` * `offset`: `int | None` * `sort_by`: `list[weave.trace_server.common_interface.SortBy] | None` *** ## class `TableQueryRes` **Pydantic Fields:** * `rows`: `list[TableRowSchema]` *** ## class `TableQueryStatsBatchReq` **Pydantic Fields:** * `project_id`: `` * `digests`: `list[str] | None` * `include_storage_size`: `bool | None` *** ## class `TableQueryStatsBatchRes` **Pydantic Fields:** * `tables`: `list[TableStatsRow]` *** ## class `TableQueryStatsReq` **Pydantic Fields:** * `project_id`: `` * `digest`: `` *** ## class `TableQueryStatsRes` **Pydantic Fields:** * `count`: `` *** ## class `TableRowFilter` **Pydantic Fields:** * `row_digests`: `list[str] | None` *** ## class `TableRowSchema` **Pydantic Fields:** * `digest`: `` * `val`: `typing.Any` * `original_index`: `int | None` *** ## class `TableSchemaForInsert` **Pydantic Fields:** * `project_id`: `` * `rows`: `list[dict[str, typing.Any]]` * `expected_digest`: `str | None` *** ## class `TableStatsRow` **Pydantic Fields:** * `count`: `` * `digest`: `` * `storage_size_bytes`: `int | None` *** ## class `TableUpdateReq` **Pydantic Fields:** * `project_id`: `` * `base_digest`: `` * `updates`: `list[TableAppendSpec | TablePopSpec | TableInsertSpec]` *** ## class `TableUpdateRes` **Pydantic Fields:** * `digest`: `` * `updated_row_digests`: `list[str]` *** ## class `TagsListReq` **Pydantic Fields:** * `project_id`: `` * `wb_user_id`: `str | None` *** ## class `TagsListRes` **Pydantic Fields:** * `tags`: `list[str]` *** ## class `ThreadSchema` **Pydantic Fields:** * `thread_id`: `` * `turn_count`: `` * `start_time`: `` * `last_updated`: `` * `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`: `` * `filter`: `ThreadsQueryFilter | None` * `limit`: `int | None` * `offset`: `int | None` * `sort_by`: `list[weave.trace_server.common_interface.SortBy] | None` *** ## class `TraceServerInterface` *** ### method `actions_execute_batch` ```python theme={null} actions_execute_batch(req: ActionsExecuteBatchReq) → ActionsExecuteBatchRes ``` *** ### method `aliases_list` ```python theme={null} aliases_list(req: AliasesListReq) → AliasesListRes ``` *** ### method `annotation_queue_add_calls` ```python theme={null} annotation_queue_add_calls( req: AnnotationQueueAddCallsReq ) → AnnotationQueueAddCallsRes ``` *** ### method `annotation_queue_create` ```python theme={null} annotation_queue_create( req: AnnotationQueueCreateReq ) → AnnotationQueueCreateRes ``` *** ### method `annotation_queue_delete` ```python theme={null} annotation_queue_delete( req: AnnotationQueueDeleteReq ) → AnnotationQueueDeleteRes ``` *** ### method `annotation_queue_items_query` ```python theme={null} annotation_queue_items_query( req: AnnotationQueueItemsQueryReq ) → AnnotationQueueItemsQueryRes ``` *** ### method `annotation_queue_read` ```python theme={null} annotation_queue_read(req: AnnotationQueueReadReq) → AnnotationQueueReadRes ``` *** ### method `annotation_queue_update` ```python theme={null} annotation_queue_update( req: AnnotationQueueUpdateReq ) → AnnotationQueueUpdateRes ``` *** ### method `annotation_queues_query_stream` ```python theme={null} annotation_queues_query_stream( req: AnnotationQueuesQueryReq ) → Iterator[AnnotationQueueSchema] ``` *** ### method `annotation_queues_stats` ```python theme={null} annotation_queues_stats( req: AnnotationQueuesStatsReq ) → AnnotationQueuesStatsRes ``` *** ### method `annotator_queue_items_progress_update` ```python theme={null} annotator_queue_items_progress_update( req: AnnotatorQueueItemsProgressUpdateReq ) → AnnotatorQueueItemsProgressUpdateRes ``` *** ### method `call_end` ```python theme={null} call_end(req: CallEndReq) → CallEndRes ``` *** ### method `call_read` ```python theme={null} call_read(req: CallReadReq) → CallReadRes ``` *** ### method `call_start` ```python theme={null} call_start(req: CallStartReq) → CallStartRes ``` *** ### method `call_start_batch` ```python theme={null} call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes ``` *** ### method `call_stats` ```python theme={null} call_stats(req: 'CallStatsReq') → CallStatsRes ``` *** ### method `call_update` ```python theme={null} call_update(req: CallUpdateReq) → CallUpdateRes ``` *** ### method `calls_delete` ```python theme={null} calls_delete(req: CallsDeleteReq) → CallsDeleteRes ``` *** ### method `calls_query` ```python theme={null} calls_query(req: CallsQueryReq) → CallsQueryRes ``` *** ### method `calls_query_stats` ```python theme={null} calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes ``` *** ### method `calls_query_stream` ```python theme={null} calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema] ``` *** ### method `calls_score` ```python theme={null} calls_score(req: CallsScoreReq) → CallsScoreRes ``` *** ### method `calls_usage` ```python theme={null} calls_usage(req: 'CallsUsageReq') → CallsUsageRes ``` *** ### method `completions_create` ```python theme={null} completions_create(req: CompletionsCreateReq) → CompletionsCreateRes ``` *** ### method `completions_create_stream` ```python theme={null} completions_create_stream(req: CompletionsCreateReq) → Iterator[dict[str, Any]] ``` *** ### method `cost_create` ```python theme={null} cost_create(req: CostCreateReq) → CostCreateRes ``` *** ### method `cost_purge` ```python theme={null} cost_purge(req: CostPurgeReq) → CostPurgeRes ``` *** ### method `cost_query` ```python theme={null} cost_query(req: CostQueryReq) → CostQueryRes ``` *** ### method `evaluate_model` ```python theme={null} evaluate_model(req: EvaluateModelReq) → EvaluateModelRes ``` *** ### method `evaluation_status` ```python theme={null} evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes ``` *** ### method `feedback_create` ```python theme={null} feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes ``` *** ### method `feedback_create_batch` ```python theme={null} feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes ``` *** ### method `feedback_payload_schema` ```python theme={null} feedback_payload_schema( req: FeedbackPayloadSchemaReq ) → FeedbackPayloadSchemaRes ``` *** ### method `feedback_purge` ```python theme={null} feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes ``` *** ### method `feedback_query` ```python theme={null} feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes ``` *** ### method `feedback_replace` ```python theme={null} feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes ``` *** ### method `feedback_stats` ```python theme={null} feedback_stats(req: FeedbackStatsReq) → FeedbackStatsRes ``` *** ### method `file_content_read` ```python theme={null} file_content_read(req: FileContentReadReq) → FileContentReadRes ``` *** ### method `file_create` ```python theme={null} file_create(req: FileCreateReq) → FileCreateRes ``` *** ### method `files_stats` ```python theme={null} files_stats(req: FilesStatsReq) → FilesStatsRes ``` *** ### method `image_create` ```python theme={null} image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes ``` *** ### method `obj_add_tags` ```python theme={null} obj_add_tags(req: ObjAddTagsReq) → ObjAddTagsRes ``` *** ### method `obj_create` ```python theme={null} obj_create(req: ObjCreateReq) → ObjCreateRes ``` *** ### method `obj_delete` ```python theme={null} obj_delete(req: ObjDeleteReq) → ObjDeleteRes ``` *** ### method `obj_read` ```python theme={null} obj_read(req: ObjReadReq) → ObjReadRes ``` *** ### method `obj_remove_aliases` ```python theme={null} obj_remove_aliases(req: ObjRemoveAliasesReq) → ObjRemoveAliasesRes ``` *** ### method `obj_remove_tags` ```python theme={null} obj_remove_tags(req: ObjRemoveTagsReq) → ObjRemoveTagsRes ``` *** ### method `obj_set_aliases` ```python theme={null} obj_set_aliases(req: ObjSetAliasesReq) → ObjSetAliasesRes ``` *** ### method `objs_query` ```python theme={null} objs_query(req: ObjQueryReq) → ObjQueryRes ``` *** ### method `otel_export` ```python theme={null} otel_export(req: OTelExportReq) → OTelExportRes ``` *** ### method `project_stats` ```python theme={null} project_stats(req: ProjectStatsReq) → ProjectStatsRes ``` *** ### method `refs_read_batch` ```python theme={null} refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes ``` *** ### method `table_create` ```python theme={null} table_create(req: TableCreateReq) → TableCreateRes ``` *** ### method `table_create_from_digests` ```python theme={null} table_create_from_digests( req: TableCreateFromDigestsReq ) → TableCreateFromDigestsRes ``` *** ### method `table_query` ```python theme={null} table_query(req: TableQueryReq) → TableQueryRes ``` *** ### method `table_query_stats` ```python theme={null} table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes ``` *** ### method `table_query_stats_batch` ```python theme={null} table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes ``` *** ### method `table_query_stream` ```python theme={null} table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema] ``` *** ### method `table_update` ```python theme={null} table_update(req: TableUpdateReq) → TableUpdateRes ``` *** ### method `tags_list` ```python theme={null} tags_list(req: TagsListReq) → TagsListRes ``` *** ### method `threads_query_stream` ```python theme={null} threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema] ``` *** ### method `trace_usage` ```python theme={null} trace_usage(req: 'TraceUsageReq') → TraceUsageRes ``` *** ## class `TraceStatus` *** ## class `TraceUsageReq` Request to compute per-call usage for a trace, with descendant rollup. This endpoint returns usage metrics for each call in the trace, where each call's metrics include the sum of its own usage plus all descendants' usage. Use this for trace view where you want to see rolled-up metrics per call. Note: All matching calls are loaded into memory for aggregation. For very large result sets (>10k calls), consider using more specific filters or pagination at the application layer. **Pydantic Fields:** * `project_id`: `` * `filter`: `CallsFilter | None` * `query`: `weave.trace_server.interface.query.Query | None` * `include_costs`: `` * `limit`: `` *** ## class `TraceUsageRes` Response with per-call usage metrics (each includes descendant contributions). **Pydantic Fields:** * `call_usage`: `dict[str, dict[str, LLMAggregatedUsage]]` * `unfinished_call_ids`: `list[str]` *** ## class `UsageMetricSpec` Specification for a usage metric to aggregate (grouped by model). **Pydantic Fields:** * `metric`: `typing.Literal['input_tokens', 'output_tokens', 'total_tokens', 'input_cost', 'output_cost', 'total_cost']` * `aggregations`: `list[AggregationType]` * `percentiles`: `list[float]` *** ## class `WeaveSummarySchema`