Workspace User

View as Markdown

The details of a User resource.

GetGET /api/2.0/identity/users/{user_id}ListGET /api/2.0/identity/usersCreatePOST /api/2.0/identity/usersUpdatePATCH /api/2.0/identity/users/{user_id}DeleteDELETE /api/2.0/identity/users/{user_id}

User object

The details of a User resource.

account_idstringBetaOutput only

The accountId parent of the user in <Databricks>.

user_idstringBetaOutput only

Internal userId of the user in <Databricks>.

external_idstringBeta

ExternalId of the user in the customer's IdP.

usernamestringBetaImmutable

Username/email of the user.

full_nameobjectBeta

Show child attributesHide child attributes

given_namestringBeta

family_namestringBeta

account_user_statusstringBeta

The activity status of a user in a <Databricks> account.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

View as Markdown

The User object

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

Get Beta

GET /api/2.0/identity/users/{user_id}

Fetches a user by its internal ID from the <Databricks> account that parents the calling workspace.

API scopes: identity

Parameters

user_idstringRequiredpath

Required. Internal ID of the user in <Databricks>.

Response

Returns the User object.

View as Markdown

Response

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

List Beta

GET /api/2.0/identity/users

Lists the users in the <Databricks> account that parents the calling workspace, returning one page per call. Supports filtering by username or external ID.

API scopes: identity

Parameters

page_sizeint32query

The maximum number of users to return. The service may return fewer than this value. If not provided, defaults to 1000, which is also the maximum allowed. Requests for more than the maximum are clamped to 1000.

page_tokenstringquery

A page token, received from a previous ListUsers call. Provide this to retrieve the subsequent page.

filterstringquery

Optional. Allows filtering users by username or external id.

Response

Returns a list of User objects.

View as Markdown

Response

{
  "users": [
    {
      "account_id": "string",
      "user_id": "string",
      "external_id": "string",
      "username": "string",
      "full_name": {},
      "account_user_status": "string"
    }
  ],
  "next_page_token": "string"
}

Create Beta

POST /api/2.0/identity/users

Creates a local user in the <Databricks> account that parents the calling workspace and returns the created user. A local user is one that is not synced from the customer's identity provider, and can be created whether or not Account Identity Management (AIM) is enabled.

When AIM is enabled, supplying an external ID returns an error. To provision the identity from your identity provider, resolve it by its external ID with ResolveUser; to read an existing external identity, use the ExternalUser resource.

API scopes: identity

Request body

userobjectRequired

Required. User to be created in <Databricks>

Show child attributesHide child attributes

external_idstring

ExternalId of the user in the customer's IdP.

usernamestringRequiredImmutable

Username/email of the user.

full_nameobjectRequired

Show child attributesHide child attributes

given_namestring

family_namestring

account_user_statusstringRequired

The activity status of a user in a <Databricks> account.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

Response

Returns the User object.

View as Markdown

Request

{
  "user": {
    "external_id": "string",
    "username": "string",
    "full_name": {},
    "account_user_status": "string"
  }
}

Response

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

Update Beta

PATCH /api/2.0/identity/users/{user_id}

Updates an existing user in the <Databricks> account that parents the calling workspace and returns the updated user. Only the fields named in the update mask are modified. The updatable fields are fullName.givenName, fullName.familyName, status, and externalId.

When AIM is enabled and the user is an external identity (its external_id is set), only external_id can be updated; its other fields are sourced from your identity provider.

API scopes: identity

Parameters

user_idstringRequiredpath

Required. Internal ID of the user in <Databricks>.

update_maskstringRequiredquery

Optional. The list of fields to update.

Request body

userobjectRequired

Required. User to be updated in <Databricks>

Show child attributesHide child attributes

external_idstring

ExternalId of the user in the customer's IdP.

usernamestringRequiredImmutable

Username/email of the user.

full_nameobjectRequired

Show child attributesHide child attributes

given_namestring

family_namestring

account_user_statusstringRequired

The activity status of a user in a <Databricks> account.

Values: STATE_UNSPECIFIED, ACTIVE, INACTIVE

Response

Returns the User object.

View as Markdown

Request

{
  "user": {
    "external_id": "string",
    "username": "string",
    "full_name": {},
    "account_user_status": "string"
  }
}

Response

{
  "account_id": "string",
  "user_id": "string",
  "external_id": "string",
  "username": "string",
  "full_name": {
    "given_name": "string",
    "family_name": "string"
  },
  "account_user_status": "string"
}

Delete Beta

DELETE /api/2.0/identity/users/{user_id}

Deletes a user by its internal ID from the <Databricks> account that parents the calling workspace.

API scopes: identity

Parameters

user_idstringRequiredpath

Required. Internal ID of the user in <Databricks>.

View as Markdown

Response

{}