Get user summary

curl --request GET \
  --url https://api.select.dev/api/{organization_id}/users/{email} \
  --header 'Authorization: Bearer <token>'

{
  "email": "<string>",
  "name": "<string>",
  "identity_provider": "<string>",
  "roles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "role": "admin",
      "scope": {
        "type": "organization",
        "id": "<string>",
        "name": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "is_default": false,
      "granted_from_team_name": "<string>"
    }
  ],
  "team_memberships": [
    {
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_name": "<string>",
      "role": "admin",
      "is_all_users_team": false
    }
  ],
  "last_login_at": "2023-11-07T05:31:56Z",
  "last_activity_at": "2023-11-07T05:31:56Z",
  "sso_groups": [
    "<string>"
  ]
}

GET

api

{organization_id}

users

{email}

Get user summary

curl --request GET \
  --url https://api.select.dev/api/{organization_id}/users/{email} \
  --header 'Authorization: Bearer <token>'

{
  "email": "<string>",
  "name": "<string>",
  "identity_provider": "<string>",
  "roles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "role": "admin",
      "scope": {
        "type": "organization",
        "id": "<string>",
        "name": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "is_default": false,
      "granted_from_team_name": "<string>"
    }
  ],
  "team_memberships": [
    {
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_name": "<string>",
      "role": "admin",
      "is_all_users_team": false
    }
  ],
  "last_login_at": "2023-11-07T05:31:56Z",
  "last_activity_at": "2023-11-07T05:31:56Z",
  "sso_groups": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

User's email address

organization_id

string

required

Response

Successful Response

Comprehensive user information including roles and team memberships.

string

required

The user's email address

name

string | null

The user's display name

identity_provider

string | null

The identity provider used for authentication

roles

PublicUserAccessRole · object[]

All direct access roles assigned to the user

Show child attributes

roles.id

string<uuid>

required

The unique identifier of this role assignment

roles.role

enum<string>

required

The role level (admin, editor, monitor_editor, or viewer)

Available options:

admin,

editor,

monitor_editor,

viewer

roles.scope

RoleScope · object

required

The scope this role applies to

Show child attributes

roles.scope.type

enum<string>

required

The type of scope for this role

Available options:

organization,

snowflake_organization,

snowflake_account,

usage_group

roles.scope.id

string | null

ID of the scoped entity (organization ID, Snowflake org name, account UUID, or usage group ID)

roles.scope.name

string | null

Display name of the scoped entity (populated in responses)

roles.created_at

string<date-time>

required

When the role was created

roles.updated_at

string<date-time>

required

When the role was last updated

roles.is_default

boolean

default:false

Whether this is a default organization role

roles.granted_from_team_name

string | null

If this role is granted FROM a team (i.e., user has this role because they're a member of the team), the team name

team_memberships

TeamMembership · object[]

Teams the user belongs to

Show child attributes

team_memberships.team_id

string<uuid>

required

The unique identifier of the team

team_memberships.team_name

string

required

The name of the team

team_memberships.role

enum<string>

required

The role level within the team

Available options:

admin,

editor,

monitor_editor,

viewer

team_memberships.is_all_users_team

boolean

default:false

Whether this is the special all-users team

When the user last logged in

last_activity_at

string<date-time> | null

When the user was last active

sso_groups

string[] | null

SSO groups from the user's last login

Delete user role List team roles

⌘I

Quickstart

API Reference

Get user summary

Authorizations

Path Parameters

Response