Skip to content
Nexa Platform Docs

List all users in the workspace

GET
/api/v1/iam/users
curl --request GET \
  --url 'https://example.com/api/v1/iam/users?live=false'

Retrieves a list of all users in the Databricks workspace with their details.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
count
Any of:
integer
>= 1 <= 1000

Maximum number of users to return

start_index
Any of:
integer
>= 1

Starting index for pagination

filter
Any of:
string

SCIM filter expression (e.g., ‘active eq true’)

live
Live

Fetch live data from Databricks API instead of cached data

boolean

Fetch live data from Databricks API instead of cached data

Header Parameters

Section titled “Header Parameters”
X-Environment-Id
Any of:
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
Examplegenerated
example

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}