@arizeai/phoenix-client 6.11.2 → 6.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -60,6 +60,54 @@ export interface paths {
60
60
  patch?: never;
61
61
  trace?: never;
62
62
  };
63
+ "/v1/projects/{project_identifier}/annotation_configs": {
64
+ parameters: {
65
+ query?: never;
66
+ header?: never;
67
+ path?: never;
68
+ cookie?: never;
69
+ };
70
+ /**
71
+ * List annotation configurations assigned to a project
72
+ * @description Retrieve a paginated list of the annotation configurations assigned to a project, identified by either project ID or project name.
73
+ */
74
+ get: operations["getProjectAnnotationConfigs"];
75
+ /**
76
+ * Replace the set of annotation configurations assigned to a project
77
+ * @description Replace the project's entire set of assigned annotation configurations with the provided set. The server diffs the desired set against the current set: configs in the body but not assigned are added, and configs assigned but not in the body are removed. An empty array clears all assignments.
78
+ */
79
+ put: operations["setProjectAnnotationConfigs"];
80
+ post?: never;
81
+ delete?: never;
82
+ options?: never;
83
+ head?: never;
84
+ patch?: never;
85
+ trace?: never;
86
+ };
87
+ "/v1/projects/{project_identifier}/annotation_configs/{config_identifier}": {
88
+ parameters: {
89
+ query?: never;
90
+ header?: never;
91
+ path?: never;
92
+ cookie?: never;
93
+ };
94
+ get?: never;
95
+ /**
96
+ * Assign an annotation configuration to a project
97
+ * @description Assign an annotation configuration to a project. This operation is idempotent: re-assigning a config that is already assigned is a no-op that returns the config. Both the project and the config are identified by either ID or name.
98
+ */
99
+ put: operations["assignAnnotationConfigToProject"];
100
+ post?: never;
101
+ /**
102
+ * Unassign an annotation configuration from a project
103
+ * @description Unassign an annotation configuration from a project. This operation is idempotent: unassigning a config that is not currently assigned is a no-op. The underlying annotation config is not deleted. Both the project and the config are identified by either ID or name.
104
+ */
105
+ delete: operations["unassignAnnotationConfigFromProject"];
106
+ options?: never;
107
+ head?: never;
108
+ patch?: never;
109
+ trace?: never;
110
+ };
63
111
  "/v1/projects/{project_identifier}/span_annotations": {
64
112
  parameters: {
65
113
  query?: never;
@@ -198,6 +246,97 @@ export interface paths {
198
246
  patch?: never;
199
247
  trace?: never;
200
248
  };
249
+ "/v1/dataset_labels": {
250
+ parameters: {
251
+ query?: never;
252
+ header?: never;
253
+ path?: never;
254
+ cookie?: never;
255
+ };
256
+ /**
257
+ * List dataset labels
258
+ * @description Retrieve a paginated list of all dataset labels in the system.
259
+ */
260
+ get: operations["listDatasetLabels"];
261
+ put?: never;
262
+ /** Create a dataset label */
263
+ post: operations["createDatasetLabel"];
264
+ delete?: never;
265
+ options?: never;
266
+ head?: never;
267
+ patch?: never;
268
+ trace?: never;
269
+ };
270
+ "/v1/dataset_labels/{label_id}": {
271
+ parameters: {
272
+ query?: never;
273
+ header?: never;
274
+ path?: never;
275
+ cookie?: never;
276
+ };
277
+ /** Get a dataset label by ID */
278
+ get: operations["getDatasetLabel"];
279
+ put?: never;
280
+ post?: never;
281
+ /**
282
+ * Delete a dataset label by ID
283
+ * @description Delete a dataset label. This also removes the label from every dataset it is applied to.
284
+ */
285
+ delete: operations["deleteDatasetLabel"];
286
+ options?: never;
287
+ head?: never;
288
+ /**
289
+ * Update a dataset label by ID
290
+ * @description Partially update a dataset label's name, color, and/or description. Only the fields included in the request body are changed; omitted fields are left as-is.
291
+ */
292
+ patch: operations["updateDatasetLabel"];
293
+ trace?: never;
294
+ };
295
+ "/v1/datasets/{dataset_identifier}/labels": {
296
+ parameters: {
297
+ query?: never;
298
+ header?: never;
299
+ path?: never;
300
+ cookie?: never;
301
+ };
302
+ /** List the labels applied to a dataset */
303
+ get: operations["listDatasetLabelsForDataset"];
304
+ /**
305
+ * Replace the set of labels applied to a dataset
306
+ * @description Replace the entire set of labels applied to a dataset. Labels present in the request but not currently applied are added; labels currently applied but absent from the request are removed. An empty list removes all labels.
307
+ */
308
+ put: operations["setDatasetLabelsForDataset"];
309
+ post?: never;
310
+ delete?: never;
311
+ options?: never;
312
+ head?: never;
313
+ patch?: never;
314
+ trace?: never;
315
+ };
316
+ "/v1/datasets/{dataset_identifier}/labels/{label_id}": {
317
+ parameters: {
318
+ query?: never;
319
+ header?: never;
320
+ path?: never;
321
+ cookie?: never;
322
+ };
323
+ get?: never;
324
+ /**
325
+ * Apply a label to a dataset
326
+ * @description Apply an existing label to a dataset. This operation is idempotent: applying a label that is already applied is a no-op that returns the label.
327
+ */
328
+ put: operations["addDatasetLabelToDataset"];
329
+ post?: never;
330
+ /**
331
+ * Remove a label from a dataset
332
+ * @description Remove a label from a dataset without deleting the label itself. This operation is idempotent: removing a label that is not applied is a no-op.
333
+ */
334
+ delete: operations["removeDatasetLabelFromDataset"];
335
+ options?: never;
336
+ head?: never;
337
+ patch?: never;
338
+ trace?: never;
339
+ };
201
340
  "/v1/datasets": {
202
341
  parameters: {
203
342
  query?: never;
@@ -1421,6 +1560,10 @@ export interface paths {
1421
1560
  export type webhooks = Record<string, never>;
1422
1561
  export interface components {
1423
1562
  schemas: {
1563
+ /** AddDatasetLabelToDatasetResponseBody */
1564
+ AddDatasetLabelToDatasetResponseBody: {
1565
+ data: components["schemas"]["DatasetLabel"];
1566
+ };
1424
1567
  /**
1425
1568
  * AgentSpanContext
1426
1569
  * @description Span the user has selected.
@@ -1526,6 +1669,11 @@ export interface components {
1526
1669
  /** Timezone */
1527
1670
  timeZone: string;
1528
1671
  };
1672
+ /** AssignAnnotationConfigToProjectResponseBody */
1673
+ AssignAnnotationConfigToProjectResponseBody: {
1674
+ /** Data */
1675
+ data: components["schemas"]["CategoricalAnnotationConfig"] | components["schemas"]["ContinuousAnnotationConfig"] | components["schemas"]["FreeformAnnotationConfig"];
1676
+ };
1529
1677
  /**
1530
1678
  * AssistantMessageMetadata
1531
1679
  * @description Wire schema for the chat stream's `message_metadata` payload.
@@ -1808,6 +1956,28 @@ export interface components {
1808
1956
  /** Data */
1809
1957
  data: components["schemas"]["CategoricalAnnotationConfig"] | components["schemas"]["ContinuousAnnotationConfig"] | components["schemas"]["FreeformAnnotationConfig"];
1810
1958
  };
1959
+ /** CreateDatasetLabelRequestBody */
1960
+ CreateDatasetLabelRequestBody: {
1961
+ /**
1962
+ * Name
1963
+ * @description The name of the dataset label
1964
+ */
1965
+ name: string;
1966
+ /**
1967
+ * Color
1968
+ * @description A lowercase hex color code (e.g. '#00cc88') used to display the label
1969
+ */
1970
+ color: string;
1971
+ /**
1972
+ * Description
1973
+ * @description An optional description of the dataset label
1974
+ */
1975
+ description?: string | null;
1976
+ };
1977
+ /** CreateDatasetLabelResponseBody */
1978
+ CreateDatasetLabelResponseBody: {
1979
+ data: components["schemas"]["DatasetLabel"];
1980
+ };
1811
1981
  /**
1812
1982
  * CreateExperimentRequestBody
1813
1983
  * @description Details of the experiment to be created
@@ -2076,6 +2246,17 @@ export interface components {
2076
2246
  */
2077
2247
  updated_at: string;
2078
2248
  };
2249
+ /** DatasetLabel */
2250
+ DatasetLabel: {
2251
+ /** Id */
2252
+ id: string;
2253
+ /** Name */
2254
+ name: string;
2255
+ /** Description */
2256
+ description: string | null;
2257
+ /** Color */
2258
+ color: string;
2259
+ };
2079
2260
  /** DatasetVersion */
2080
2261
  DatasetVersion: {
2081
2262
  /** Version Id */
@@ -2609,6 +2790,17 @@ export interface components {
2609
2790
  /** Next Cursor */
2610
2791
  next_cursor: string | null;
2611
2792
  };
2793
+ /** GetDatasetLabelResponseBody */
2794
+ GetDatasetLabelResponseBody: {
2795
+ data: components["schemas"]["DatasetLabel"];
2796
+ };
2797
+ /** GetDatasetLabelsResponseBody */
2798
+ GetDatasetLabelsResponseBody: {
2799
+ /** Data */
2800
+ data: components["schemas"]["DatasetLabel"][];
2801
+ /** Next Cursor */
2802
+ next_cursor: string | null;
2803
+ };
2612
2804
  /** GetDatasetResponseBody */
2613
2805
  GetDatasetResponseBody: {
2614
2806
  data: components["schemas"]["DatasetWithExampleCount"];
@@ -2631,6 +2823,13 @@ export interface components {
2631
2823
  /** Next Cursor */
2632
2824
  next_cursor: string | null;
2633
2825
  };
2826
+ /** GetProjectAnnotationConfigsResponseBody */
2827
+ GetProjectAnnotationConfigsResponseBody: {
2828
+ /** Data */
2829
+ data: (components["schemas"]["CategoricalAnnotationConfig"] | components["schemas"]["ContinuousAnnotationConfig"] | components["schemas"]["FreeformAnnotationConfig"])[];
2830
+ /** Next Cursor */
2831
+ next_cursor: string | null;
2832
+ };
2634
2833
  /** GetProjectResponseBody */
2635
2834
  GetProjectResponseBody: {
2636
2835
  data: components["schemas"]["Project"];
@@ -2838,6 +3037,11 @@ export interface components {
2838
3037
  ListDatasetExamplesResponseBody: {
2839
3038
  data: components["schemas"]["ListDatasetExamplesData"];
2840
3039
  };
3040
+ /** ListDatasetLabelsForDatasetResponseBody */
3041
+ ListDatasetLabelsForDatasetResponseBody: {
3042
+ /** Data */
3043
+ data: components["schemas"]["DatasetLabel"][];
3044
+ };
2841
3045
  /** ListDatasetVersionsResponseBody */
2842
3046
  ListDatasetVersionsResponseBody: {
2843
3047
  /** Data */
@@ -4371,6 +4575,34 @@ export interface components {
4371
4575
  */
4372
4576
  end_time: string;
4373
4577
  };
4578
+ /** SetDatasetLabelsForDatasetResponseBody */
4579
+ SetDatasetLabelsForDatasetResponseBody: {
4580
+ /** Data */
4581
+ data: components["schemas"]["DatasetLabel"][];
4582
+ };
4583
+ /** SetDatasetLabelsRequestBody */
4584
+ SetDatasetLabelsRequestBody: {
4585
+ /**
4586
+ * Dataset Label Ids
4587
+ * @description The complete set of dataset label GlobalIDs to apply to the dataset. Labels not in this list are removed from the dataset; an empty list removes all labels.
4588
+ */
4589
+ dataset_label_ids?: string[];
4590
+ };
4591
+ /** SetProjectAnnotationConfigsRequestBody */
4592
+ SetProjectAnnotationConfigsRequestBody: {
4593
+ /**
4594
+ * Annotation Config Ids
4595
+ * @description The complete set of annotation configuration GlobalIDs that should be assigned to the project. Configs not in this list are unassigned; an empty list clears all assignments.
4596
+ */
4597
+ annotation_config_ids: string[];
4598
+ };
4599
+ /** SetProjectAnnotationConfigsResponseBody */
4600
+ SetProjectAnnotationConfigsResponseBody: {
4601
+ /** Data */
4602
+ data: (components["schemas"]["CategoricalAnnotationConfig"] | components["schemas"]["ContinuousAnnotationConfig"] | components["schemas"]["FreeformAnnotationConfig"])[];
4603
+ /** Next Cursor */
4604
+ next_cursor: string | null;
4605
+ };
4374
4606
  /**
4375
4607
  * SourceDocumentUIPart
4376
4608
  * @description A document source part of a message.
@@ -5254,6 +5486,31 @@ export interface components {
5254
5486
  /** Data */
5255
5487
  data: components["schemas"]["CategoricalAnnotationConfig"] | components["schemas"]["ContinuousAnnotationConfig"] | components["schemas"]["FreeformAnnotationConfig"];
5256
5488
  };
5489
+ /**
5490
+ * UpdateDatasetLabelRequestBody
5491
+ * @description Fields to update on a dataset label. Omit a field to leave it unchanged.
5492
+ */
5493
+ UpdateDatasetLabelRequestBody: {
5494
+ /**
5495
+ * Name
5496
+ * @description New name for the label (null is rejected; name is required)
5497
+ */
5498
+ name?: string | null;
5499
+ /**
5500
+ * Color
5501
+ * @description New lowercase hex color code for the label (null is rejected)
5502
+ */
5503
+ color?: string | null;
5504
+ /**
5505
+ * Description
5506
+ * @description New description for the label (null clears the description)
5507
+ */
5508
+ description?: string | null;
5509
+ };
5510
+ /** UpdateDatasetLabelResponseBody */
5511
+ UpdateDatasetLabelResponseBody: {
5512
+ data: components["schemas"]["DatasetLabel"];
5513
+ };
5257
5514
  /**
5258
5515
  * UpdateExperimentRequestBody
5259
5516
  * @description Fields to update on an experiment. Omit a field to leave it unchanged.
@@ -5681,38 +5938,30 @@ export interface operations {
5681
5938
  };
5682
5939
  };
5683
5940
  };
5684
- listSpanAnnotationsBySpanIds: {
5941
+ getProjectAnnotationConfigs: {
5685
5942
  parameters: {
5686
5943
  query?: {
5687
- /** @description Optional list of span ids to fetch annotations for. If omitted, `identifier` must be supplied. */
5688
- span_ids?: string[] | null;
5689
- /** @description Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters. */
5690
- identifier?: string[] | null;
5691
- /** @description Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default). */
5692
- include_annotation_names?: string[] | null;
5693
- /** @description Optional list of annotation names to exclude from results. */
5694
- exclude_annotation_names?: string[] | null;
5695
- /** @description A cursor for pagination */
5944
+ /** @description Cursor for pagination (base64-encoded annotation config ID) */
5696
5945
  cursor?: string | null;
5697
- /** @description The maximum number of annotations to return in a single request */
5946
+ /** @description Maximum number of configs to return */
5698
5947
  limit?: number;
5699
5948
  };
5700
5949
  header?: never;
5701
5950
  path: {
5702
- /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
5951
+ /** @description The project identifier: either project ID or project name. */
5703
5952
  project_identifier: string;
5704
5953
  };
5705
5954
  cookie?: never;
5706
5955
  };
5707
5956
  requestBody?: never;
5708
5957
  responses: {
5709
- /** @description Successful Response */
5958
+ /** @description A list of the project's annotation configurations with pagination information */
5710
5959
  200: {
5711
5960
  headers: {
5712
5961
  [name: string]: unknown;
5713
5962
  };
5714
5963
  content: {
5715
- "application/json": components["schemas"]["SpanAnnotationsResponseBody"];
5964
+ "application/json": components["schemas"]["GetProjectAnnotationConfigsResponseBody"];
5716
5965
  };
5717
5966
  };
5718
5967
  /** @description Forbidden */
@@ -5724,7 +5973,7 @@ export interface operations {
5724
5973
  "text/plain": string;
5725
5974
  };
5726
5975
  };
5727
- /** @description Project or spans not found */
5976
+ /** @description Not Found */
5728
5977
  404: {
5729
5978
  headers: {
5730
5979
  [name: string]: unknown;
@@ -5733,7 +5982,7 @@ export interface operations {
5733
5982
  "text/plain": string;
5734
5983
  };
5735
5984
  };
5736
- /** @description Invalid parameters */
5985
+ /** @description Unprocessable Entity */
5737
5986
  422: {
5738
5987
  headers: {
5739
5988
  [name: string]: unknown;
@@ -5744,37 +5993,30 @@ export interface operations {
5744
5993
  };
5745
5994
  };
5746
5995
  };
5747
- deleteSpanAnnotations: {
5996
+ setProjectAnnotationConfigs: {
5748
5997
  parameters: {
5749
- query?: {
5750
- /** @description Optional annotation name. When provided, must be non-empty and narrows the delete to annotations of that name. */
5751
- name?: string | null;
5752
- /** @description Optional annotation identifier. When provided, must be non-empty and narrows the delete to annotations with that identifier. */
5753
- identifier?: string | null;
5754
- /** @description Optional annotator kind. When provided, narrows the delete to annotations produced by this annotator kind. */
5755
- annotator_kind?: ("LLM" | "CODE" | "HUMAN") | null;
5756
- /** @description Optional inclusive lower bound on `created_at` (>=). Naive datetimes are interpreted as UTC. */
5757
- start_time?: string | null;
5758
- /** @description Optional exclusive upper bound on `created_at` (<). Naive datetimes are interpreted as UTC. */
5759
- end_time?: string | null;
5760
- /** @description Opt-in flag that authorizes the request without a bounded `[start_time, end_time)` time window. When `false` (default) or absent, the request must supply both `start_time` AND `end_time` to bound the delete. When `true`, the time-range bound is waived and any other filters (`name`, `identifier`, `annotator_kind`) still narrow the delete within the project — e.g. `delete_all=true&name=X` deletes all annotations named X regardless of time. */
5761
- delete_all?: boolean;
5762
- };
5998
+ query?: never;
5763
5999
  header?: never;
5764
6000
  path: {
5765
- /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
6001
+ /** @description The project identifier: either project ID or project name. */
5766
6002
  project_identifier: string;
5767
6003
  };
5768
6004
  cookie?: never;
5769
6005
  };
5770
- requestBody?: never;
6006
+ requestBody: {
6007
+ content: {
6008
+ "application/json": components["schemas"]["SetProjectAnnotationConfigsRequestBody"];
6009
+ };
6010
+ };
5771
6011
  responses: {
5772
- /** @description Successful Response */
5773
- 204: {
6012
+ /** @description The resulting set of annotation configurations assigned to the project */
6013
+ 200: {
5774
6014
  headers: {
5775
6015
  [name: string]: unknown;
5776
6016
  };
5777
- content?: never;
6017
+ content: {
6018
+ "application/json": components["schemas"]["SetProjectAnnotationConfigsResponseBody"];
6019
+ };
5778
6020
  };
5779
6021
  /** @description Forbidden */
5780
6022
  403: {
@@ -5785,7 +6027,7 @@ export interface operations {
5785
6027
  "text/plain": string;
5786
6028
  };
5787
6029
  };
5788
- /** @description Project not found */
6030
+ /** @description Not Found */
5789
6031
  404: {
5790
6032
  headers: {
5791
6033
  [name: string]: unknown;
@@ -5794,7 +6036,7 @@ export interface operations {
5794
6036
  "text/plain": string;
5795
6037
  };
5796
6038
  };
5797
- /** @description Invalid parameters */
6039
+ /** @description Unprocessable Entity */
5798
6040
  422: {
5799
6041
  headers: {
5800
6042
  [name: string]: unknown;
@@ -5805,38 +6047,27 @@ export interface operations {
5805
6047
  };
5806
6048
  };
5807
6049
  };
5808
- listTraceAnnotationsByTraceIds: {
6050
+ assignAnnotationConfigToProject: {
5809
6051
  parameters: {
5810
- query?: {
5811
- /** @description Optional list of trace ids to fetch annotations for. If omitted, `identifier` must be supplied. */
5812
- trace_ids?: string[] | null;
5813
- /** @description Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters. */
5814
- identifier?: string[] | null;
5815
- /** @description Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default). */
5816
- include_annotation_names?: string[] | null;
5817
- /** @description Optional list of annotation names to exclude from results. */
5818
- exclude_annotation_names?: string[] | null;
5819
- /** @description A cursor for pagination */
5820
- cursor?: string | null;
5821
- /** @description The maximum number of annotations to return in a single request */
5822
- limit?: number;
5823
- };
6052
+ query?: never;
5824
6053
  header?: never;
5825
6054
  path: {
5826
- /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
6055
+ /** @description The project identifier: either project ID or project name. */
5827
6056
  project_identifier: string;
6057
+ /** @description The annotation configuration identifier: either ID or name. */
6058
+ config_identifier: string;
5828
6059
  };
5829
6060
  cookie?: never;
5830
6061
  };
5831
6062
  requestBody?: never;
5832
6063
  responses: {
5833
- /** @description Successful Response */
6064
+ /** @description The annotation configuration assigned to the project */
5834
6065
  200: {
5835
6066
  headers: {
5836
6067
  [name: string]: unknown;
5837
6068
  };
5838
6069
  content: {
5839
- "application/json": components["schemas"]["TraceAnnotationsResponseBody"];
6070
+ "application/json": components["schemas"]["AssignAnnotationConfigToProjectResponseBody"];
5840
6071
  };
5841
6072
  };
5842
6073
  /** @description Forbidden */
@@ -5848,7 +6079,7 @@ export interface operations {
5848
6079
  "text/plain": string;
5849
6080
  };
5850
6081
  };
5851
- /** @description Project or traces not found */
6082
+ /** @description Not Found */
5852
6083
  404: {
5853
6084
  headers: {
5854
6085
  [name: string]: unknown;
@@ -5857,7 +6088,7 @@ export interface operations {
5857
6088
  "text/plain": string;
5858
6089
  };
5859
6090
  };
5860
- /** @description Invalid parameters */
6091
+ /** @description Unprocessable Entity */
5861
6092
  422: {
5862
6093
  headers: {
5863
6094
  [name: string]: unknown;
@@ -5868,25 +6099,262 @@ export interface operations {
5868
6099
  };
5869
6100
  };
5870
6101
  };
5871
- deleteTraceAnnotations: {
6102
+ unassignAnnotationConfigFromProject: {
5872
6103
  parameters: {
5873
- query?: {
5874
- /** @description Optional annotation name. When provided, must be non-empty and narrows the delete to annotations of that name. */
5875
- name?: string | null;
5876
- /** @description Optional annotation identifier. When provided, must be non-empty and narrows the delete to annotations with that identifier. */
5877
- identifier?: string | null;
5878
- /** @description Optional annotator kind. When provided, narrows the delete to annotations produced by this annotator kind. */
5879
- annotator_kind?: ("LLM" | "CODE" | "HUMAN") | null;
5880
- /** @description Optional inclusive lower bound on `created_at` (>=). Naive datetimes are interpreted as UTC. */
5881
- start_time?: string | null;
5882
- /** @description Optional exclusive upper bound on `created_at` (<). Naive datetimes are interpreted as UTC. */
5883
- end_time?: string | null;
5884
- /** @description Opt-in flag that authorizes the request without a bounded `[start_time, end_time)` time window. When `false` (default) or absent, the request must supply both `start_time` AND `end_time` to bound the delete. When `true`, the time-range bound is waived and any other filters (`name`, `identifier`, `annotator_kind`) still narrow the delete within the project — e.g. `delete_all=true&name=X` deletes all annotations named X regardless of time. */
5885
- delete_all?: boolean;
5886
- };
6104
+ query?: never;
5887
6105
  header?: never;
5888
6106
  path: {
5889
- /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
6107
+ /** @description The project identifier: either project ID or project name. */
6108
+ project_identifier: string;
6109
+ /** @description The annotation configuration identifier: either ID or name. */
6110
+ config_identifier: string;
6111
+ };
6112
+ cookie?: never;
6113
+ };
6114
+ requestBody?: never;
6115
+ responses: {
6116
+ /** @description No content returned on successful unassignment */
6117
+ 204: {
6118
+ headers: {
6119
+ [name: string]: unknown;
6120
+ };
6121
+ content?: never;
6122
+ };
6123
+ /** @description Forbidden */
6124
+ 403: {
6125
+ headers: {
6126
+ [name: string]: unknown;
6127
+ };
6128
+ content: {
6129
+ "text/plain": string;
6130
+ };
6131
+ };
6132
+ /** @description Not Found */
6133
+ 404: {
6134
+ headers: {
6135
+ [name: string]: unknown;
6136
+ };
6137
+ content: {
6138
+ "text/plain": string;
6139
+ };
6140
+ };
6141
+ /** @description Unprocessable Entity */
6142
+ 422: {
6143
+ headers: {
6144
+ [name: string]: unknown;
6145
+ };
6146
+ content: {
6147
+ "text/plain": string;
6148
+ };
6149
+ };
6150
+ };
6151
+ };
6152
+ listSpanAnnotationsBySpanIds: {
6153
+ parameters: {
6154
+ query?: {
6155
+ /** @description Optional list of span ids to fetch annotations for. If omitted, `identifier` must be supplied. */
6156
+ span_ids?: string[] | null;
6157
+ /** @description Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters. */
6158
+ identifier?: string[] | null;
6159
+ /** @description Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default). */
6160
+ include_annotation_names?: string[] | null;
6161
+ /** @description Optional list of annotation names to exclude from results. */
6162
+ exclude_annotation_names?: string[] | null;
6163
+ /** @description A cursor for pagination */
6164
+ cursor?: string | null;
6165
+ /** @description The maximum number of annotations to return in a single request */
6166
+ limit?: number;
6167
+ };
6168
+ header?: never;
6169
+ path: {
6170
+ /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
6171
+ project_identifier: string;
6172
+ };
6173
+ cookie?: never;
6174
+ };
6175
+ requestBody?: never;
6176
+ responses: {
6177
+ /** @description Successful Response */
6178
+ 200: {
6179
+ headers: {
6180
+ [name: string]: unknown;
6181
+ };
6182
+ content: {
6183
+ "application/json": components["schemas"]["SpanAnnotationsResponseBody"];
6184
+ };
6185
+ };
6186
+ /** @description Forbidden */
6187
+ 403: {
6188
+ headers: {
6189
+ [name: string]: unknown;
6190
+ };
6191
+ content: {
6192
+ "text/plain": string;
6193
+ };
6194
+ };
6195
+ /** @description Project or spans not found */
6196
+ 404: {
6197
+ headers: {
6198
+ [name: string]: unknown;
6199
+ };
6200
+ content: {
6201
+ "text/plain": string;
6202
+ };
6203
+ };
6204
+ /** @description Invalid parameters */
6205
+ 422: {
6206
+ headers: {
6207
+ [name: string]: unknown;
6208
+ };
6209
+ content: {
6210
+ "text/plain": string;
6211
+ };
6212
+ };
6213
+ };
6214
+ };
6215
+ deleteSpanAnnotations: {
6216
+ parameters: {
6217
+ query?: {
6218
+ /** @description Optional annotation name. When provided, must be non-empty and narrows the delete to annotations of that name. */
6219
+ name?: string | null;
6220
+ /** @description Optional annotation identifier. When provided, must be non-empty and narrows the delete to annotations with that identifier. */
6221
+ identifier?: string | null;
6222
+ /** @description Optional annotator kind. When provided, narrows the delete to annotations produced by this annotator kind. */
6223
+ annotator_kind?: ("LLM" | "CODE" | "HUMAN") | null;
6224
+ /** @description Optional inclusive lower bound on `created_at` (>=). Naive datetimes are interpreted as UTC. */
6225
+ start_time?: string | null;
6226
+ /** @description Optional exclusive upper bound on `created_at` (<). Naive datetimes are interpreted as UTC. */
6227
+ end_time?: string | null;
6228
+ /** @description Opt-in flag that authorizes the request without a bounded `[start_time, end_time)` time window. When `false` (default) or absent, the request must supply both `start_time` AND `end_time` to bound the delete. When `true`, the time-range bound is waived and any other filters (`name`, `identifier`, `annotator_kind`) still narrow the delete within the project — e.g. `delete_all=true&name=X` deletes all annotations named X regardless of time. */
6229
+ delete_all?: boolean;
6230
+ };
6231
+ header?: never;
6232
+ path: {
6233
+ /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
6234
+ project_identifier: string;
6235
+ };
6236
+ cookie?: never;
6237
+ };
6238
+ requestBody?: never;
6239
+ responses: {
6240
+ /** @description Successful Response */
6241
+ 204: {
6242
+ headers: {
6243
+ [name: string]: unknown;
6244
+ };
6245
+ content?: never;
6246
+ };
6247
+ /** @description Forbidden */
6248
+ 403: {
6249
+ headers: {
6250
+ [name: string]: unknown;
6251
+ };
6252
+ content: {
6253
+ "text/plain": string;
6254
+ };
6255
+ };
6256
+ /** @description Project not found */
6257
+ 404: {
6258
+ headers: {
6259
+ [name: string]: unknown;
6260
+ };
6261
+ content: {
6262
+ "text/plain": string;
6263
+ };
6264
+ };
6265
+ /** @description Invalid parameters */
6266
+ 422: {
6267
+ headers: {
6268
+ [name: string]: unknown;
6269
+ };
6270
+ content: {
6271
+ "text/plain": string;
6272
+ };
6273
+ };
6274
+ };
6275
+ };
6276
+ listTraceAnnotationsByTraceIds: {
6277
+ parameters: {
6278
+ query?: {
6279
+ /** @description Optional list of trace ids to fetch annotations for. If omitted, `identifier` must be supplied. */
6280
+ trace_ids?: string[] | null;
6281
+ /** @description Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters. */
6282
+ identifier?: string[] | null;
6283
+ /** @description Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default). */
6284
+ include_annotation_names?: string[] | null;
6285
+ /** @description Optional list of annotation names to exclude from results. */
6286
+ exclude_annotation_names?: string[] | null;
6287
+ /** @description A cursor for pagination */
6288
+ cursor?: string | null;
6289
+ /** @description The maximum number of annotations to return in a single request */
6290
+ limit?: number;
6291
+ };
6292
+ header?: never;
6293
+ path: {
6294
+ /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
6295
+ project_identifier: string;
6296
+ };
6297
+ cookie?: never;
6298
+ };
6299
+ requestBody?: never;
6300
+ responses: {
6301
+ /** @description Successful Response */
6302
+ 200: {
6303
+ headers: {
6304
+ [name: string]: unknown;
6305
+ };
6306
+ content: {
6307
+ "application/json": components["schemas"]["TraceAnnotationsResponseBody"];
6308
+ };
6309
+ };
6310
+ /** @description Forbidden */
6311
+ 403: {
6312
+ headers: {
6313
+ [name: string]: unknown;
6314
+ };
6315
+ content: {
6316
+ "text/plain": string;
6317
+ };
6318
+ };
6319
+ /** @description Project or traces not found */
6320
+ 404: {
6321
+ headers: {
6322
+ [name: string]: unknown;
6323
+ };
6324
+ content: {
6325
+ "text/plain": string;
6326
+ };
6327
+ };
6328
+ /** @description Invalid parameters */
6329
+ 422: {
6330
+ headers: {
6331
+ [name: string]: unknown;
6332
+ };
6333
+ content: {
6334
+ "text/plain": string;
6335
+ };
6336
+ };
6337
+ };
6338
+ };
6339
+ deleteTraceAnnotations: {
6340
+ parameters: {
6341
+ query?: {
6342
+ /** @description Optional annotation name. When provided, must be non-empty and narrows the delete to annotations of that name. */
6343
+ name?: string | null;
6344
+ /** @description Optional annotation identifier. When provided, must be non-empty and narrows the delete to annotations with that identifier. */
6345
+ identifier?: string | null;
6346
+ /** @description Optional annotator kind. When provided, narrows the delete to annotations produced by this annotator kind. */
6347
+ annotator_kind?: ("LLM" | "CODE" | "HUMAN") | null;
6348
+ /** @description Optional inclusive lower bound on `created_at` (>=). Naive datetimes are interpreted as UTC. */
6349
+ start_time?: string | null;
6350
+ /** @description Optional exclusive upper bound on `created_at` (<). Naive datetimes are interpreted as UTC. */
6351
+ end_time?: string | null;
6352
+ /** @description Opt-in flag that authorizes the request without a bounded `[start_time, end_time)` time window. When `false` (default) or absent, the request must supply both `start_time` AND `end_time` to bound the delete. When `true`, the time-range bound is waived and any other filters (`name`, `identifier`, `annotator_kind`) still narrow the delete within the project — e.g. `delete_all=true&name=X` deletes all annotations named X regardless of time. */
6353
+ delete_all?: boolean;
6354
+ };
6355
+ header?: never;
6356
+ path: {
6357
+ /** @description The project identifier: either project ID or project name. If using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters. */
5890
6358
  project_identifier: string;
5891
6359
  };
5892
6360
  cookie?: never;
@@ -6053,6 +6521,467 @@ export interface operations {
6053
6521
  };
6054
6522
  };
6055
6523
  };
6524
+ listDatasetLabels: {
6525
+ parameters: {
6526
+ query?: {
6527
+ /** @description Cursor for pagination (a dataset label GlobalID) */
6528
+ cursor?: string | null;
6529
+ /** @description The max number of dataset labels to return at a time. */
6530
+ limit?: number;
6531
+ };
6532
+ header?: never;
6533
+ path?: never;
6534
+ cookie?: never;
6535
+ };
6536
+ requestBody?: never;
6537
+ responses: {
6538
+ /** @description Successful Response */
6539
+ 200: {
6540
+ headers: {
6541
+ [name: string]: unknown;
6542
+ };
6543
+ content: {
6544
+ "application/json": components["schemas"]["GetDatasetLabelsResponseBody"];
6545
+ };
6546
+ };
6547
+ /** @description Forbidden */
6548
+ 403: {
6549
+ headers: {
6550
+ [name: string]: unknown;
6551
+ };
6552
+ content: {
6553
+ "text/plain": string;
6554
+ };
6555
+ };
6556
+ /** @description Unprocessable Entity */
6557
+ 422: {
6558
+ headers: {
6559
+ [name: string]: unknown;
6560
+ };
6561
+ content: {
6562
+ "text/plain": string;
6563
+ };
6564
+ };
6565
+ };
6566
+ };
6567
+ createDatasetLabel: {
6568
+ parameters: {
6569
+ query?: never;
6570
+ header?: never;
6571
+ path?: never;
6572
+ cookie?: never;
6573
+ };
6574
+ requestBody: {
6575
+ content: {
6576
+ "application/json": components["schemas"]["CreateDatasetLabelRequestBody"];
6577
+ };
6578
+ };
6579
+ responses: {
6580
+ /** @description Successful Response */
6581
+ 201: {
6582
+ headers: {
6583
+ [name: string]: unknown;
6584
+ };
6585
+ content: {
6586
+ "application/json": components["schemas"]["CreateDatasetLabelResponseBody"];
6587
+ };
6588
+ };
6589
+ /** @description Forbidden */
6590
+ 403: {
6591
+ headers: {
6592
+ [name: string]: unknown;
6593
+ };
6594
+ content: {
6595
+ "text/plain": string;
6596
+ };
6597
+ };
6598
+ /** @description A dataset label with the same name already exists */
6599
+ 409: {
6600
+ headers: {
6601
+ [name: string]: unknown;
6602
+ };
6603
+ content: {
6604
+ "text/plain": string;
6605
+ };
6606
+ };
6607
+ /** @description Invalid request body */
6608
+ 422: {
6609
+ headers: {
6610
+ [name: string]: unknown;
6611
+ };
6612
+ content: {
6613
+ "text/plain": string;
6614
+ };
6615
+ };
6616
+ };
6617
+ };
6618
+ getDatasetLabel: {
6619
+ parameters: {
6620
+ query?: never;
6621
+ header?: never;
6622
+ path: {
6623
+ /** @description The ID of the dataset label */
6624
+ label_id: string;
6625
+ };
6626
+ cookie?: never;
6627
+ };
6628
+ requestBody?: never;
6629
+ responses: {
6630
+ /** @description Successful Response */
6631
+ 200: {
6632
+ headers: {
6633
+ [name: string]: unknown;
6634
+ };
6635
+ content: {
6636
+ "application/json": components["schemas"]["GetDatasetLabelResponseBody"];
6637
+ };
6638
+ };
6639
+ /** @description Forbidden */
6640
+ 403: {
6641
+ headers: {
6642
+ [name: string]: unknown;
6643
+ };
6644
+ content: {
6645
+ "text/plain": string;
6646
+ };
6647
+ };
6648
+ /** @description Dataset label not found */
6649
+ 404: {
6650
+ headers: {
6651
+ [name: string]: unknown;
6652
+ };
6653
+ content: {
6654
+ "text/plain": string;
6655
+ };
6656
+ };
6657
+ /** @description Invalid dataset label ID */
6658
+ 422: {
6659
+ headers: {
6660
+ [name: string]: unknown;
6661
+ };
6662
+ content: {
6663
+ "text/plain": string;
6664
+ };
6665
+ };
6666
+ };
6667
+ };
6668
+ deleteDatasetLabel: {
6669
+ parameters: {
6670
+ query?: never;
6671
+ header?: never;
6672
+ path: {
6673
+ /** @description The ID of the dataset label */
6674
+ label_id: string;
6675
+ };
6676
+ cookie?: never;
6677
+ };
6678
+ requestBody?: never;
6679
+ responses: {
6680
+ /** @description Successful Response */
6681
+ 204: {
6682
+ headers: {
6683
+ [name: string]: unknown;
6684
+ };
6685
+ content?: never;
6686
+ };
6687
+ /** @description Forbidden */
6688
+ 403: {
6689
+ headers: {
6690
+ [name: string]: unknown;
6691
+ };
6692
+ content: {
6693
+ "text/plain": string;
6694
+ };
6695
+ };
6696
+ /** @description Dataset label not found */
6697
+ 404: {
6698
+ headers: {
6699
+ [name: string]: unknown;
6700
+ };
6701
+ content: {
6702
+ "text/plain": string;
6703
+ };
6704
+ };
6705
+ /** @description Invalid dataset label ID */
6706
+ 422: {
6707
+ headers: {
6708
+ [name: string]: unknown;
6709
+ };
6710
+ content: {
6711
+ "text/plain": string;
6712
+ };
6713
+ };
6714
+ };
6715
+ };
6716
+ updateDatasetLabel: {
6717
+ parameters: {
6718
+ query?: never;
6719
+ header?: never;
6720
+ path: {
6721
+ /** @description The ID of the dataset label */
6722
+ label_id: string;
6723
+ };
6724
+ cookie?: never;
6725
+ };
6726
+ requestBody: {
6727
+ content: {
6728
+ "application/json": components["schemas"]["UpdateDatasetLabelRequestBody"];
6729
+ };
6730
+ };
6731
+ responses: {
6732
+ /** @description Successful Response */
6733
+ 200: {
6734
+ headers: {
6735
+ [name: string]: unknown;
6736
+ };
6737
+ content: {
6738
+ "application/json": components["schemas"]["UpdateDatasetLabelResponseBody"];
6739
+ };
6740
+ };
6741
+ /** @description Forbidden */
6742
+ 403: {
6743
+ headers: {
6744
+ [name: string]: unknown;
6745
+ };
6746
+ content: {
6747
+ "text/plain": string;
6748
+ };
6749
+ };
6750
+ /** @description Dataset label not found */
6751
+ 404: {
6752
+ headers: {
6753
+ [name: string]: unknown;
6754
+ };
6755
+ content: {
6756
+ "text/plain": string;
6757
+ };
6758
+ };
6759
+ /** @description A dataset label with the same name already exists */
6760
+ 409: {
6761
+ headers: {
6762
+ [name: string]: unknown;
6763
+ };
6764
+ content: {
6765
+ "text/plain": string;
6766
+ };
6767
+ };
6768
+ /** @description Invalid dataset label ID or request body */
6769
+ 422: {
6770
+ headers: {
6771
+ [name: string]: unknown;
6772
+ };
6773
+ content: {
6774
+ "text/plain": string;
6775
+ };
6776
+ };
6777
+ };
6778
+ };
6779
+ listDatasetLabelsForDataset: {
6780
+ parameters: {
6781
+ query?: never;
6782
+ header?: never;
6783
+ path: {
6784
+ /** @description The dataset identifier: either the dataset ID (GlobalID) or its name. */
6785
+ dataset_identifier: string;
6786
+ };
6787
+ cookie?: never;
6788
+ };
6789
+ requestBody?: never;
6790
+ responses: {
6791
+ /** @description Successful Response */
6792
+ 200: {
6793
+ headers: {
6794
+ [name: string]: unknown;
6795
+ };
6796
+ content: {
6797
+ "application/json": components["schemas"]["ListDatasetLabelsForDatasetResponseBody"];
6798
+ };
6799
+ };
6800
+ /** @description Forbidden */
6801
+ 403: {
6802
+ headers: {
6803
+ [name: string]: unknown;
6804
+ };
6805
+ content: {
6806
+ "text/plain": string;
6807
+ };
6808
+ };
6809
+ /** @description Dataset not found */
6810
+ 404: {
6811
+ headers: {
6812
+ [name: string]: unknown;
6813
+ };
6814
+ content: {
6815
+ "text/plain": string;
6816
+ };
6817
+ };
6818
+ /** @description Invalid dataset identifier */
6819
+ 422: {
6820
+ headers: {
6821
+ [name: string]: unknown;
6822
+ };
6823
+ content: {
6824
+ "text/plain": string;
6825
+ };
6826
+ };
6827
+ };
6828
+ };
6829
+ setDatasetLabelsForDataset: {
6830
+ parameters: {
6831
+ query?: never;
6832
+ header?: never;
6833
+ path: {
6834
+ /** @description The dataset identifier: either the dataset ID (GlobalID) or its name. */
6835
+ dataset_identifier: string;
6836
+ };
6837
+ cookie?: never;
6838
+ };
6839
+ requestBody: {
6840
+ content: {
6841
+ "application/json": components["schemas"]["SetDatasetLabelsRequestBody"];
6842
+ };
6843
+ };
6844
+ responses: {
6845
+ /** @description Successful Response */
6846
+ 200: {
6847
+ headers: {
6848
+ [name: string]: unknown;
6849
+ };
6850
+ content: {
6851
+ "application/json": components["schemas"]["SetDatasetLabelsForDatasetResponseBody"];
6852
+ };
6853
+ };
6854
+ /** @description Forbidden */
6855
+ 403: {
6856
+ headers: {
6857
+ [name: string]: unknown;
6858
+ };
6859
+ content: {
6860
+ "text/plain": string;
6861
+ };
6862
+ };
6863
+ /** @description Dataset or one or more dataset labels not found */
6864
+ 404: {
6865
+ headers: {
6866
+ [name: string]: unknown;
6867
+ };
6868
+ content: {
6869
+ "text/plain": string;
6870
+ };
6871
+ };
6872
+ /** @description Invalid dataset identifier or request body */
6873
+ 422: {
6874
+ headers: {
6875
+ [name: string]: unknown;
6876
+ };
6877
+ content: {
6878
+ "text/plain": string;
6879
+ };
6880
+ };
6881
+ };
6882
+ };
6883
+ addDatasetLabelToDataset: {
6884
+ parameters: {
6885
+ query?: never;
6886
+ header?: never;
6887
+ path: {
6888
+ /** @description The dataset identifier: either the dataset ID (GlobalID) or its name. */
6889
+ dataset_identifier: string;
6890
+ /** @description The ID of the dataset label to apply */
6891
+ label_id: string;
6892
+ };
6893
+ cookie?: never;
6894
+ };
6895
+ requestBody?: never;
6896
+ responses: {
6897
+ /** @description Successful Response */
6898
+ 200: {
6899
+ headers: {
6900
+ [name: string]: unknown;
6901
+ };
6902
+ content: {
6903
+ "application/json": components["schemas"]["AddDatasetLabelToDatasetResponseBody"];
6904
+ };
6905
+ };
6906
+ /** @description Forbidden */
6907
+ 403: {
6908
+ headers: {
6909
+ [name: string]: unknown;
6910
+ };
6911
+ content: {
6912
+ "text/plain": string;
6913
+ };
6914
+ };
6915
+ /** @description Dataset or dataset label not found */
6916
+ 404: {
6917
+ headers: {
6918
+ [name: string]: unknown;
6919
+ };
6920
+ content: {
6921
+ "text/plain": string;
6922
+ };
6923
+ };
6924
+ /** @description Invalid dataset identifier or dataset label ID */
6925
+ 422: {
6926
+ headers: {
6927
+ [name: string]: unknown;
6928
+ };
6929
+ content: {
6930
+ "text/plain": string;
6931
+ };
6932
+ };
6933
+ };
6934
+ };
6935
+ removeDatasetLabelFromDataset: {
6936
+ parameters: {
6937
+ query?: never;
6938
+ header?: never;
6939
+ path: {
6940
+ /** @description The dataset identifier: either the dataset ID (GlobalID) or its name. */
6941
+ dataset_identifier: string;
6942
+ /** @description The ID of the dataset label to remove */
6943
+ label_id: string;
6944
+ };
6945
+ cookie?: never;
6946
+ };
6947
+ requestBody?: never;
6948
+ responses: {
6949
+ /** @description Successful Response */
6950
+ 204: {
6951
+ headers: {
6952
+ [name: string]: unknown;
6953
+ };
6954
+ content?: never;
6955
+ };
6956
+ /** @description Forbidden */
6957
+ 403: {
6958
+ headers: {
6959
+ [name: string]: unknown;
6960
+ };
6961
+ content: {
6962
+ "text/plain": string;
6963
+ };
6964
+ };
6965
+ /** @description Dataset not found */
6966
+ 404: {
6967
+ headers: {
6968
+ [name: string]: unknown;
6969
+ };
6970
+ content: {
6971
+ "text/plain": string;
6972
+ };
6973
+ };
6974
+ /** @description Invalid dataset identifier or dataset label ID */
6975
+ 422: {
6976
+ headers: {
6977
+ [name: string]: unknown;
6978
+ };
6979
+ content: {
6980
+ "text/plain": string;
6981
+ };
6982
+ };
6983
+ };
6984
+ };
6056
6985
  listDatasets: {
6057
6986
  parameters: {
6058
6987
  query?: {
@@ -8272,6 +9201,8 @@ export interface operations {
8272
9201
  include_experiment_projects?: boolean;
8273
9202
  /** @description Include dataset evaluator projects in the response. Dataset evaluator projects are created when running experiments with persisted evaluators. */
8274
9203
  include_dataset_evaluator_projects?: boolean;
9204
+ /** @description Return only projects whose name contains this substring (case-insensitive). */
9205
+ name_contains?: string | null;
8275
9206
  };
8276
9207
  header?: never;
8277
9208
  path?: never;