> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.select.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create a usage group > Create a new usage group within a usage group set. Usage groups define filters and budgets for tracking specific subsets of Snowflake usage. ## OpenAPI ````yaml https://api.select.dev/public_openapi post /api/{organization_id}/usage-group-sets/{usage_group_set_id}/usage-groups openapi: 3.1.0 info: title: SELECT API (v1) version: 0.1.0 servers: - url: https://api.select.dev/ description: SELECT API security: [] paths: /api/{organization_id}/usage-group-sets/{usage_group_set_id}/usage-groups: post: tags: - usage-group-sets - public-api summary: Create a usage group description: >- Create a new usage group within a usage group set. Usage groups define filters and budgets for tracking specific subsets of Snowflake usage. operationId: >- create_usage_group_route_api__organization_id__usage_group_sets__usage_group_set_id__usage_groups_post parameters: - name: usage_group_set_id in: path required: true schema: type: string format: uuid description: The ID of the usage group set title: Usage Group Set Id description: The ID of the usage group set - name: organization_id in: path required: true schema: type: string title: Organization Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PublicUsageGroupCreate' description: >- The usage group configuration to create. Must include either a filter_expression object or filter_expression_json string. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicUsageGroup' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] - HTTPBearer: [] components: schemas: PublicUsageGroupCreate: properties: filter_expression: anyOf: - $ref: >- #/components/schemas/backend__entities__metrics__base__schemas__filters__FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input__2 - type: 'null' description: >- A structured filter expression object that defines which Snowflake usage will be attributed to this usage group. The available dimensions depend on the usage group set's scope: account, organization, team, or Select organization. Use exactly one of filter_expression or filter_expression_json. filter_expression_json: anyOf: - type: string - type: 'null' title: Filter Expression Json description: >- A JSON string representation of the filter expression. This is primarily used for Terraform provider support. Use exactly one of filter_expression or filter_expression_json. This value will be validated in the same manner as filter_expression. name: type: string title: Name description: >- The name of the usage group. Must be unique within the usage group set and cannot be empty. budget: anyOf: - type: number - type: 'null' title: Budget description: >- The budget allocated to this usage group in credits. If not specified, the usage group will have no budget limit. usage_group_set_id: type: string format: uuid title: Usage Group Set Id description: >- The ID of the usage group set this usage group belongs to. Must match the usage_group_set_id in the URL path. order: type: integer title: Order description: >- The display order and cost allocation precedence of the usage group within its usage group set. Must be a non-negative integer. When usage groups have overlapping filter expressions, cost allocation goes to the usage group with the lowest order value first. We strongly recommend using unique order values per usage group within a set. additionalProperties: false type: object required: - name - usage_group_set_id - order title: PublicUsageGroupCreate PublicUsageGroup: properties: filter_expression: $ref: >- #/components/schemas/backend__entities__metrics__base__schemas__filters__FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output__2 description: >- The structured filter expression object that defines which Snowflake usage is attributed to this usage group. filter_expression_json: type: string title: Filter Expression Json description: >- The JSON string representation of the filter expression, used by the terraform provider. id: type: string format: uuid title: Id description: The unique identifier of the usage group. created_at: type: string format: date-time title: Created At description: The timestamp when the usage group was created. updated_at: type: string format: date-time title: Updated At description: The timestamp when the usage group was last updated. usage_group_set_id: type: string format: uuid title: Usage Group Set Id description: The ID of the usage group set this usage group belongs to. name: type: string title: Name description: The name of the usage group. budget: anyOf: - type: number - type: 'null' title: Budget description: >- The budget allocated to this usage group in credits. Null indicates no budget limit. order: type: integer title: Order description: >- The display order and cost allocation precedence of the usage group within its usage group set. Lower values have higher precedence for cost allocation when filter expressions overlap. usage_group_set_name: type: string title: Usage Group Set Name description: The name of the usage group set this usage group belongs to. type: object required: - filter_expression - filter_expression_json - id - created_at - updated_at - usage_group_set_id - name - order - usage_group_set_name title: PublicUsageGroup HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError backend__entities__metrics__base__schemas__filters__FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input__2: properties: operator: type: string enum: - and - or title: Operator filters: items: anyOf: - $ref: >- #/components/schemas/backend__entities__metrics__base__schemas__filters__FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input__2 - $ref: >- #/components/schemas/EqFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input - $ref: >- #/components/schemas/InFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input - $ref: >- #/components/schemas/ArrayContainsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input - $ref: >- #/components/schemas/IsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input - $ref: >- #/components/schemas/LikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input - $ref: >- #/components/schemas/MultiLikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input - $ref: >- #/components/schemas/InRelativeDateRangeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input type: array title: Filters component_type: anyOf: - type: string const: Resource Filter - type: 'null' title: Component Type type: object required: - operator - filters title: >- FilterExpression[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] backend__entities__metrics__base__schemas__filters__FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output__2: properties: operator: type: string enum: - and - or title: Operator filters: items: anyOf: - $ref: >- #/components/schemas/backend__entities__metrics__base__schemas__filters__FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output__2 - $ref: >- #/components/schemas/EqFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/InFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/ArrayContainsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/IsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/LikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/MultiLikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/InRelativeDateRangeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output type: array title: Filters component_type: anyOf: - type: string const: Resource Filter - type: 'null' title: Component Type type: object required: - operator - filters title: >- FilterExpression[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError EqFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' title: Value operator: type: string enum: - '>' - '>=' - < - <= - '=' - '!=' title: Operator type: object required: - field - value - operator title: >- EqFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] InFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' type: array title: Values operator: type: string enum: - in - not in title: Operator type: object required: - field - values - operator title: >- InFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] ArrayContainsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' type: array title: Values operator: type: string const: array_contains title: Operator type: object required: - field - values - operator title: >- ArrayContainsFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] IsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: 'null' title: Value operator: type: string enum: - is - is not title: Operator type: object required: - field - operator title: >- IsFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] LikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: string title: Value operator: type: string enum: - ilike - startswith - array_contains_prefix - array_contains_substring title: Operator type: object required: - field - value - operator title: >- LikeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] MultiLikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: type: string type: array title: Values operator: type: string enum: - ilike - startswith title: Operator type: object required: - field - values - operator title: >- MultiLikeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] InRelativeDateRangeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Input: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: string title: Value operator: type: string enum: - in range - not in range title: Operator type: object required: - field - value - operator title: >- InRelativeDateRangeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] EqFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' title: Value operator: type: string enum: - '>' - '>=' - < - <= - '=' - '!=' title: Operator type: object required: - field - value - operator title: >- EqFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] InFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' type: array title: Values operator: type: string enum: - in - not in title: Operator type: object required: - field - values - operator title: >- InFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] ArrayContainsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' type: array title: Values operator: type: string const: array_contains title: Operator type: object required: - field - values - operator title: >- ArrayContainsFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] IsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: 'null' title: Value operator: type: string enum: - is - is not title: Operator type: object required: - field - operator title: >- IsFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] LikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: string title: Value operator: type: string enum: - ilike - startswith - array_contains_prefix - array_contains_substring title: Operator type: object required: - field - value - operator title: >- LikeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] MultiLikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: type: string type: array title: Values operator: type: string enum: - ilike - startswith title: Operator type: object required: - field - values - operator title: >- MultiLikeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] InRelativeDateRangeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: string title: Value operator: type: string enum: - in range - not in range title: Operator type: object required: - field - value - operator title: >- InRelativeDateRangeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_: properties: field: $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' path: items: type: string type: array title: Path type: object required: - field - path title: SemiStructuredDimension[SelectOrganizationUsageGroupDimensions] SelectOrganizationUsageGroupDimensions: type: string enum: - bigquery_billed_project - bigquery_query_project - bigquery_source_type - connection_id - bigquery_reservation_labels_map - bigquery_reservation_labels - bigquery_organization - bigquery_billing_export_project - bigquery_billing_account - bigquery_reservation_id - bigquery_edition - bigquery_statement_type - bigquery_job_type - bigquery_pricing_model - bigquery_principal_subject - bigquery_priority - bigquery_job_id - bigquery_query_dialect - bigquery_state - bigquery_error_reason - bigquery_admin_project_id - bigquery_query_pattern_id - databricks_pipeline_name - databricks_pipeline_tags - databricks_pipeline_tags_map - databricks_job_name - databricks_job_tags - databricks_job_tags_map - databricks_cluster_id - databricks_cluster_name - databricks_cluster_tags - databricks_cluster_tags_map - databricks_warehouse_id - databricks_sql_warehouse_name - databricks_warehouse_tags - databricks_warehouse_tags_map - databricks_app_name - databricks_base_environment_id - databricks_billing_origin_product - databricks_budget_policy_id - databricks_compute_resource_name - databricks_compute_size - databricks_data_quality_monitoring_schema_id - databricks_data_quality_monitoring_table_id - databricks_database_instance_id - databricks_genie_agent_id - databricks_genie_surface - databricks_is_photon - databricks_model_serving_endpoint_id - databricks_model_serving_endpoint_name - databricks_networking_associated_product - databricks_networking_client - databricks_networking_destination_region - databricks_networking_private_endpoint_name - databricks_networking_recipient_id - databricks_networking_source_region - databricks_notebook_path - databricks_storage_api_type - databricks_usage_type - databricks_account_id - databricks_workspace_id - databricks_workspace_name - databricks_compute_type - databricks_is_serverless - databricks_jobs_tier - databricks_sql_tier - databricks_dlt_tier - databricks_node_type - databricks_run_as - databricks_created_by - databricks_owned_by - databricks_sku_name - compute_pool_name - application_name - base_tables_accessed - base_schemas_accessed - base_databases_accessed - base_tables_accessed_csv - tables_modified - schemas_modified - databases_modified - tables_modified_csv - database_tags - database_tags_map - object_database_tags - object_database_tags_map - object_schema_tags - object_schema_tags_map - object_name_tags - object_name_tags_map - object_level_tags - object_level_tags_map - resource_type - nice_resource_type - identifying_metadata - dbt_node_tags - dbt_target_database_schema_name - dbt_resource_database_schema_name - usage_group_metadata - task_database_name - task_database_schema_name - task_fully_qualified_name - stored_procedure_database_name - stored_procedure_database_schema_name - stored_procedure_fully_qualified_name - dynamic_table_database_name - dynamic_table_database_schema_name - dynamic_table_fully_qualified_name - warehouse_name - warehouse_tags - warehouse_tags_map - user_name - user_tags - user_tags_map - role_name - role_tags - role_tags_map - database_name - schema_name - database_schema_name - fivetran_database_schema_name - custom_workload_app_workload_id - query_type - snowflake_intelligence_instance - snowflake_account_name - snowflake_org_name - account_name - account_locator - region - service_level - managed_by - account_name_and_warehouse - usage_type - account_name_and_usage_type - account_metadata - connection_type - platform_organization - platform_instance - platform_instance_name securitySchemes: HTTPBearer: type: http scheme: bearer ````