WatchEye
Browse endpoints
View as Markdown OpenAPI spec

Show user

GET /api/v1/users/{user_uuid} operationId: user.get

Base: https://portal.watcheye.com.au/api/v1/users/{user_uuid}

Return a single user by UUID.

Path parameters

FieldDescription
user_uuid string (uuid)

The user UUID

Example: 123e4567-e89b-12d3-a456-426614174000

Responses

200

User response

application/json
FieldDescription
data object

The user details
data.uuid string (uuid)

The user's UUID

Example: 123e4567-e89b-12d3-a456-426614174000
data.username string

The user's username

Example: jenny.doe@example
data.first_name string

The user's first name

Example: Jenny
data.last_name string

The user's last name

Example: Doe
data.email string

The user's email address

Example: jenny.doe@example.com
data.phone string

The user's phone number

Example: 0412345678
data.enabled boolean

Whether the user is enabled

Example: true
data.roles array of strings

The user's roles

  • account_manager - Account Manager
  • security_manager - Security Functions (update SAML settings and related security settings)
  • vpn_access - VPN Access (Permits access from known VPN connections)

Note: This will be an empty array if the user has no special roles assigned to them.
data.last_login_at string (date-time) or null

The user's last login timestamp (ISO 8601 format)

Example: 2021-01-01T00:00:00Z
data.created_at string (date-time)

The user's creation timestamp (ISO 8601 format)

Example: 2021-01-01T00:00:00Z
data.updated_at string (date-time)

The user's last update timestamp (ISO 8601 format)

Example: 2021-01-01T00:00:00Z
api_reference string (uuid)

A unique identifier for this request. This can be used to track the request in the logs and audit trail.

Example: 123e4567-e89b-12d3-a456-426614174000
Standard error responses: 400 401 402 403 429 5XX See common error responses
Previous List users Next Update user