@@ -24074,6 +24074,87 @@ paths:
2407424074 start: '2025-01-01T00:00:00Z'
2407524075 schema:
2407624076 properties:
24077+ classifier_dimensions:
24078+ description: >-
24079+ Group results by custom classifier tags, breaking down metrics by the specified dimension values.
24080+ Requires an active classifier on the workspace.
24081+ properties:
24082+ classifier_id:
24083+ description: UUID of the classifier whose tags to group by.
24084+ example: 550e8400-e29b-41d4-a716-446655440000
24085+ format: uuid
24086+ type: string
24087+ dimension_names:
24088+ items:
24089+ description: >-
24090+ Classifier dimension name (snake_case identifier). When exactly one name is provided, the
24091+ response uses it as the column key; with multiple names or none, the response uses
24092+ `clf_dimension_name`/`clf_dimension_value` columns.
24093+ example: department
24094+ type: string
24095+ maxItems: 10
24096+ type: array
24097+ include_nulls:
24098+ description: >-
24099+ When true, also include generations that have no tag from this classifier. Defaults to false,
24100+ which returns only classified generations.
24101+ type: boolean
24102+ required:
24103+ - classifier_id
24104+ type: object
24105+ classifier_filters:
24106+ description: >-
24107+ Filter results to generations with specific classifier tag values. Can be combined with
24108+ classifier_dimensions (must use the same classifier_id) or used independently with standard
24109+ dimensions.
24110+ properties:
24111+ classifier_id:
24112+ description: >-
24113+ UUID of the classifier whose tags to filter by. Must match classifier_dimensions.classifier_id
24114+ when both are specified.
24115+ example: 550e8400-e29b-41d4-a716-446655440000
24116+ format: uuid
24117+ type: string
24118+ filters:
24119+ items:
24120+ properties:
24121+ field:
24122+ description: >-
24123+ Classifier dimension name to filter on (snake_case identifier, e.g. "department",
24124+ "work_type").
24125+ example: department
24126+ type: string
24127+ operator:
24128+ description: >-
24129+ Filter operator. Only equality/set operators are supported (eq, neq, in, not_in) — ordered
24130+ comparisons are not available because classification values are strings.
24131+ example: eq
24132+ type: string
24133+ value:
24134+ anyOf:
24135+ - type: string
24136+ - format: double
24137+ type: number
24138+ - items:
24139+ anyOf:
24140+ - type: string
24141+ - format: double
24142+ type: number
24143+ type: array
24144+ description: Filter value. Use a scalar (string or number) for eq/neq, or an array for in/not_in.
24145+ example: Engineering
24146+ required:
24147+ - field
24148+ - operator
24149+ - value
24150+ type: object
24151+ maxItems: 10
24152+ minItems: 1
24153+ type: array
24154+ required:
24155+ - classifier_id
24156+ - filters
24157+ type: object
2407724158 dimensions:
2407824159 items:
2407924160 description: Dimension to group by (up to 2). Use the /meta endpoint for available dimensions.
0 commit comments