Skip to main content
PUT
/
api
/
{organization_id}
/
usage-group-sets
/
{usage_group_set_id}
Update a usage group set
curl --request PUT \
  --url https://api.select.dev/api/{organization_id}/usage-group-sets/{usage_group_set_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "order": 123
}
'
{
  "name": "<string>",
  "order": 123,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "snowflake_account_uuid": "<string>",
  "snowflake_organization_name": "<string>",
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
usage_group_set_id
string<uuid>
required

The ID of the usage group set to update

​
organization_id
string
required

Body

application/json

The usage group set updates to apply. Only specified fields will be updated.

​
id
string<uuid>
required

The unique identifier of the usage group set to update. Must match the ID in the URL path.

​
name
string | null

The new name of the usage group set. If provided, must not be empty.

​
order
integer | null

The new display order of the usage group set. If provided, must be a non-negative integer.

Response

Successful Response

​
name
string
required

The name of the usage group set. Should be unique within the organization and cannot be empty.

​
order
integer
required

The display order of the usage group set. Must be a non-negative integer. Lower values appear first.

​
id
string<uuid>
required

The unique identifier of the usage group set.

​
snowflake_account_uuid
string | null
deprecated

DEPRECATED: This field is deprecated and will be ignored, it will be removed in a future version. Usage group sets are now scoped using team_id or default to Select organization scope.

​
snowflake_organization_name
string | null
deprecated

DEPRECATED: This field is deprecated and will be ignored, it will be removed in a future version. Usage group sets are now scoped using team_id or default to Select organization scope.

​
team_id
string<uuid> | null

The UUID of the team this usage group set is scoped to. Use team_id or none (for Select organization scope).