# SELECT

- [Quickstart guide](https://api-docs.select.dev/api-reference/introduction.md): Get started with the SELECT API
- [List users](https://api-docs.select.dev/api-reference/users/list-users.md): Retrieve all users in an organization with pagination.
- [Update Snowflake Account Credentials](https://api-docs.select.dev/api-reference/snowflake-accounts/update-snowflake-account-credentials.md)
- [List usage group sets](https://api-docs.select.dev/api-reference/usage-group-sets/list-usage-group-sets.md): Retrieve all usage group sets within an organization that the API key has access to.
- [Create a usage group set](https://api-docs.select.dev/api-reference/usage-group-sets/create-a-usage-group-set.md): Create a new usage group set within an organization. Usage group sets are collections of usage groups that help organize and categorize your Snowflake usage tracking.
- [Get a usage group set](https://api-docs.select.dev/api-reference/usage-group-sets/get-a-usage-group-set.md): Retrieve a specific usage group set by its ID.
- [Update a usage group set](https://api-docs.select.dev/api-reference/usage-group-sets/update-a-usage-group-set.md): Update an existing usage group set. Only the provided fields will be updated.
- [Delete a usage group set](https://api-docs.select.dev/api-reference/usage-group-sets/delete-a-usage-group-set.md): Delete a usage group set and all its associated usage groups.
- [List usage groups](https://api-docs.select.dev/api-reference/usage-group-sets/list-usage-groups.md): Retrieve all usage groups within a specific usage group set.
- [Create a usage group](https://api-docs.select.dev/api-reference/usage-group-sets/create-a-usage-group.md): Create a new usage group within a usage group set. Usage groups define filters and budgets for tracking specific subsets of Snowflake usage.
- [Get a usage group](https://api-docs.select.dev/api-reference/usage-group-sets/get-a-usage-group.md): Retrieve a specific usage group by its ID.
- [Update a usage group](https://api-docs.select.dev/api-reference/usage-group-sets/update-a-usage-group.md): Update an existing usage group. Only the provided fields will be updated.
- [Delete a usage group](https://api-docs.select.dev/api-reference/usage-group-sets/delete-a-usage-group.md): Delete a usage group from its usage group set.
- [Get usage group set with usage groups](https://api-docs.select.dev/api-reference/usage-group-sets/get-usage-group-set-with-usage-groups.md): Retrieve a usage group set along with all its current usage groups in a single response.
- [Create a new version of a usage group set](https://api-docs.select.dev/api-reference/usage-group-sets/create-a-new-version-of-a-usage-group-set.md): Create a new version of a usage group set with a copy of all current usage groups. This is useful when you want to preserve the current state before making changes.
- [List teams](https://api-docs.select.dev/api-reference/teams/list-teams.md): Retrieve all teams within an organization
- [Create a team](https://api-docs.select.dev/api-reference/teams/create-a-team.md): Create a new team within an organization. The team will be created without any members or roles initially. Use the dedicated member and role endpoints to add members and roles to the team.
- [Get team details](https://api-docs.select.dev/api-reference/teams/get-team-details.md): Retrieve detailed information about a specific team with paginated members and roles.
- [Update a team](https://api-docs.select.dev/api-reference/teams/update-a-team.md): Update an existing team's information. Currently only the team name can be updated.
- [Delete a team](https://api-docs.select.dev/api-reference/teams/delete-a-team.md): Delete a team from the organization. This will also remove all team memberships and role assignments.
- [List team members](https://api-docs.select.dev/api-reference/teams/list-team-members.md): Retrieve all members of a team including users and SSO groups
- [Add team member](https://api-docs.select.dev/api-reference/teams/add-team-member.md): Add a user or SSO group to a team
- [Update team member](https://api-docs.select.dev/api-reference/teams/update-team-member.md): Update a team member's role
- [Remove team member](https://api-docs.select.dev/api-reference/teams/remove-team-member.md): Remove a user or SSO group from a team
- [List user roles](https://api-docs.select.dev/api-reference/roles/list-user-roles.md): Retrieve direct, default, and team-inherited roles assigned to a user
- [Create user role](https://api-docs.select.dev/api-reference/roles/create-user-role.md): Assign a new direct role to a user
- [Get user role](https://api-docs.select.dev/api-reference/roles/get-user-role.md): Retrieve details of a specific user role assignment
- [Update user role](https://api-docs.select.dev/api-reference/roles/update-user-role.md): Update a user's role level
- [Delete user role](https://api-docs.select.dev/api-reference/roles/delete-user-role.md): Remove a direct role assignment from a user
- [Get user summary](https://api-docs.select.dev/api-reference/roles/get-user-summary.md): Retrieve comprehensive information about a user
- [List team roles](https://api-docs.select.dev/api-reference/roles/list-team-roles.md): Retrieve all roles granted to a team
- [Create team role](https://api-docs.select.dev/api-reference/roles/create-team-role.md): Grant a new role to a team
- [Delete team role](https://api-docs.select.dev/api-reference/roles/delete-team-role.md): Remove a role from a team
- [List SSO group mappings](https://api-docs.select.dev/api-reference/sso/list-sso-group-mappings.md): Retrieve all SSO groups with their role assignments
- [Create SSO group mapping](https://api-docs.select.dev/api-reference/sso/create-sso-group-mapping.md): Create a new SSO group with initial role assignments
- [Update SSO group mapping](https://api-docs.select.dev/api-reference/sso/update-sso-group-mapping.md): Update an SSO group name
- [Delete SSO group mapping](https://api-docs.select.dev/api-reference/sso/delete-sso-group-mapping.md): Remove all role assignments for an SSO group
- [Add role to SSO group](https://api-docs.select.dev/api-reference/sso/add-role-to-sso-group.md): Add a new role assignment to an existing SSO group
- [Remove role from SSO group](https://api-docs.select.dev/api-reference/sso/remove-role-from-sso-group.md): Remove a specific role assignment from an SSO group
- [Quickstart guide](https://api-docs.select.dev/v2/introduction.md): Get started with the SELECT API v2
- [Export audit logs](https://api-docs.select.dev/v2-api-reference/audit-logs/export-audit-logs.md): Append-only, oldest-first stream of audit log records, designed for continuous polling (e.g. SIEM export). Records are immutable once written.
- [Create a usage group set](https://api-docs.select.dev/v2-api-reference/usage-group-sets/create-a-usage-group-set.md)
- [List usage group sets](https://api-docs.select.dev/v2-api-reference/usage-group-sets/list-usage-group-sets.md)
- [Get a usage group set](https://api-docs.select.dev/v2-api-reference/usage-group-sets/get-a-usage-group-set.md)
- [Update a usage group set](https://api-docs.select.dev/v2-api-reference/usage-group-sets/update-a-usage-group-set.md)
- [Delete a usage group set](https://api-docs.select.dev/v2-api-reference/usage-group-sets/delete-a-usage-group-set.md)
- [List a usage group set's versions](https://api-docs.select.dev/v2-api-reference/usage-group-sets/list-a-usage-group-sets-versions.md)
- [List usage groups in a set](https://api-docs.select.dev/v2-api-reference/usage-group-sets/list-usage-groups-in-a-set.md)
- [Create a usage group](https://api-docs.select.dev/v2-api-reference/usage-group-sets/create-a-usage-group.md)
- [Replace all usage groups in a set](https://api-docs.select.dev/v2-api-reference/usage-group-sets/replace-all-usage-groups-in-a-set.md)
- [Get a usage group](https://api-docs.select.dev/v2-api-reference/usage-group-sets/get-a-usage-group.md)
- [Update a usage group](https://api-docs.select.dev/v2-api-reference/usage-group-sets/update-a-usage-group.md)
- [Delete a usage group](https://api-docs.select.dev/v2-api-reference/usage-group-sets/delete-a-usage-group.md)
- [Create a team](https://api-docs.select.dev/v2-api-reference/teams/create-a-team.md): Create a team in your organization.
- [List teams](https://api-docs.select.dev/v2-api-reference/teams/list-teams.md): List the teams in your organization.
- [Get a team](https://api-docs.select.dev/v2-api-reference/teams/get-a-team.md): Get a single team by id.
- [Update a team](https://api-docs.select.dev/v2-api-reference/teams/update-a-team.md): Update a team's name or default member role.
- [Delete a team](https://api-docs.select.dev/v2-api-reference/teams/delete-a-team.md): Delete a team, along with its memberships and role grants.
- [List team members](https://api-docs.select.dev/v2-api-reference/teams/list-team-members.md): List a team's explicit members — the users and SSO groups assigned to it.
- [Add a team member](https://api-docs.select.dev/v2-api-reference/teams/add-a-team-member.md): Add a user or SSO group to a team.
- [Update a team member](https://api-docs.select.dev/v2-api-reference/teams/update-a-team-member.md): Update a team member's role.
- [Remove a team member](https://api-docs.select.dev/v2-api-reference/teams/remove-a-team-member.md): Remove a user or SSO group from a team.
- [Set team memberships for a batch of users](https://api-docs.select.dev/v2-api-reference/teams/set-team-memberships-for-a-batch-of-users.md): Set the explicit team memberships for one or more users.
- [List roles granted to a team](https://api-docs.select.dev/v2-api-reference/teams/list-roles-granted-to-a-team.md): List the roles granted to a team, each with the scope it applies to.
- [Grant a role to a team](https://api-docs.select.dev/v2-api-reference/teams/grant-a-role-to-a-team.md): Grant a role to a team, scoped to a resource or to the whole organization.
- [Revoke a role from a team](https://api-docs.select.dev/v2-api-reference/teams/revoke-a-role-from-a-team.md): Revoke a role from a team.
- [List users](https://api-docs.select.dev/v2-api-reference/users/list-users.md)
- [Remove a user from the organization](https://api-docs.select.dev/v2-api-reference/users/remove-a-user-from-the-organization.md): Removes the user from the organization and deletes their SELECT login, along with any roles granted to them. This cannot be undone — the user must be invited again to regain access.
- [Set direct role grants for a batch of users](https://api-docs.select.dev/v2-api-reference/users/set-direct-role-grants-for-a-batch-of-users.md): Set the direct role grants for one or more users, by email.
- [List the roles a user holds](https://api-docs.select.dev/v2-api-reference/users/list-the-roles-a-user-holds.md): List every role a user holds, each with the scope it applies to.
- [Grant a role to a user](https://api-docs.select.dev/v2-api-reference/users/grant-a-role-to-a-user.md): Grant a role to a user, scoped to a resource or to the whole organization.
- [Get a role a user holds](https://api-docs.select.dev/v2-api-reference/users/get-a-role-a-user-holds.md): Get a single role the user holds, from any of its three sources.
- [Update a role granted to a user](https://api-docs.select.dev/v2-api-reference/users/update-a-role-granted-to-a-user.md): Change the role level of a grant made to this user directly.
- [Revoke a role from a user](https://api-docs.select.dev/v2-api-reference/users/revoke-a-role-from-a-user.md): Revoke a role granted to this user directly.
- [Create a default role grant](https://api-docs.select.dev/v2-api-reference/default-roles/create-a-default-role-grant.md): Grant a role to every member of your organization by default.
- [List default role grants](https://api-docs.select.dev/v2-api-reference/default-roles/list-default-role-grants.md): List the roles every member of your organization holds by default.
- [Delete a default role grant](https://api-docs.select.dev/v2-api-reference/default-roles/delete-a-default-role-grant.md): Revoke a default role grant. Members stop holding it immediately.
- [Create an SSO group](https://api-docs.select.dev/v2-api-reference/sso-groups/create-an-sso-group.md): Map a group from your identity provider and grant it its first roles.
- [List SSO groups](https://api-docs.select.dev/v2-api-reference/sso-groups/list-sso-groups.md): List the SSO groups mapped in your organization.
- [Get an SSO group](https://api-docs.select.dev/v2-api-reference/sso-groups/get-an-sso-group.md): Get a single SSO group by id, which is its name.
- [Rename an SSO group](https://api-docs.select.dev/v2-api-reference/sso-groups/rename-an-sso-group.md): Rename an SSO group, keeping the roles it grants.
- [Delete an SSO group](https://api-docs.select.dev/v2-api-reference/sso-groups/delete-an-sso-group.md): Delete an SSO group and every role it grants.
- [List roles granted to an SSO group](https://api-docs.select.dev/v2-api-reference/sso-groups/list-roles-granted-to-an-sso-group.md): List the roles granted to a group, each with the scope it applies to.
- [Grant a role to an SSO group](https://api-docs.select.dev/v2-api-reference/sso-groups/grant-a-role-to-an-sso-group.md): Grant a role to a group, scoped to a resource or to the whole organization.
- [Revoke a role from an SSO group](https://api-docs.select.dev/v2-api-reference/sso-groups/revoke-a-role-from-an-sso-group.md): Revoke a role from a group.
- [Invite a user](https://api-docs.select.dev/v2-api-reference/invitations/invite-a-user.md): Emails an invitation to join the organization. The invitee joins with no roles until they are granted some.
- [List invitations](https://api-docs.select.dev/v2-api-reference/invitations/list-invitations.md): Lists the organization's pending invitations, oldest first. An invitation leaves the list once it is accepted or revoked.
- [Revoke an invitation](https://api-docs.select.dev/v2-api-reference/invitations/revoke-an-invitation.md): Revokes a pending invitation, so its link no longer lets the invitee join.

## OpenAPI Specs

- [public_openapi](https://api.select.dev/public_openapi)
- [openapi](https://api.select.dev/v2/openapi.json)