users_search_response

countinteger

items object[]

Array [

idstring<uuid>

The UUID of the returned object

Example: eef4aefc-d64e-4c2c-aba4-4914c86ce059

source_user_idstring

The originating unique identifer for the user (UUID from local user store, principal from LDAP, ..) - only returned by the Role Store API

createdstring<date-time>

When the object was created

Example: 2017-01-01T15:05:05Z

updatedstring<date-time>

When the object was created

Example: 2017-01-01T15:05:05Z

updated_bystring<uuid>

ID of the user who updated the object

Example: eef4aefc-d64e-4c2c-aba4-4914c86ce059

authorstring<uuid>

ID of the user who originally authored the object

Example: eef4aefc-d64e-4c2c-aba4-4914c86ce059

commentstring

A comment describing the object

Example: A comment

tagsstring[]

Array of tag strings

principalstring

The principal name of the user. For IAM Local User Store users, the username.

distinguished_namestring

The distinguished name of the user

given_namestring

First name

full_namestring

Full name

job_titlestring

Job title

companystring

Company

departmentstring

Department

emailstring

Email address

telephonestring

Phone number

localestring

User's locale. Language code ISO 639-1 & country code ISO 3166-1 separated by a "_"

Example: fi_FI

attributes object[]

Custom user attributes array.

Array [

keystringrequired

Example: aws_account

valuestringrequired

Example: admin-bob

]

sourcestring

Source ID

mfa object

statusstring

Possible values: [ENABLED, DISABLED, UNINITIALIZED]

seed object

seed_stringstring

The MFA seed in textual format

seed_qr_codestring

The MFA-seed QR code in base64 encoded format (PNG file)

stale_access_tokenboolean

The access token used for fetching the user object has permissions that are out of sync. The requester should refresh the access token before the next REST API call. This field is set only by /users/current endpoint.

authorized_keys object[]

Array [

idstring<uuid>

Unique identifier for authorized key

Example: 2765b005-4ce1-4b2b-a9ca-ee6c4d6f2792

usernamestring

Username of the authorized key owner

Example: joe@privx.com

user_idstring<uuid>

User id of the authorized key owner

Example: f2f448d8-0397-4894-982f-9a58a43921db

sourcestring<uuid>

User source ID

namestringrequired

Name for authorized key

Example: work

commentstring

Comment for authorized key

Example: Joe's work laptop key

public_keystringrequired

Public key data in ssh authorized key format

Example: AAAAB3NzaC1yc2EAAAADAQABAAABAQDqoMogqErOw7lL3GD6Ez7Hv1FZBk0Iyk2pBFUhqb9sjY9IEw8P9OWFwLMhWQ4LNvekPAnmr03pMHSSP7Pw98+Izy0HxcHZGKcrDOIjnHF5Fog3w4rBYa6OxdcJRxctifx5szqmM4JkUNS1RJY5E4ns4xCgFV46Satph02M+eP9PXGh+ZecSNtdLoOovVuolEUdb8dINgto8zsjEuAQ+76qOEgAIuSsYlzGGZPyPnATtkUi/rK9fcAfbhSqSXNxFqf7wejEKwA1kFt8hSW2bUWJH268fqnejFwHjBTzjBw89dji6141ajAP8/Q2gZug0bb1U70PE4afE3fFh2VCfhwT

not_beforestring<date-time>

Start of key validity period

Example: 2020-07-31T17:32:28Z

not_afterstring<date-time>

End of key validity period

Example: 2022-07-31T17:32:28Z

expires_ininteger

Time in seconds to key expiry. Value is not set if key is not yet valid.

source_addressstring[]

fingerprintsstring[]

]

webauthn_credentials object[]

Array [

idstring<uuid>required

Credential UUID

credential_idstring

Webauthn credential ID

namestring

Credential name

commentstring

Optional comment

last_usedstring<date-time>

Timestamp of last login event using this credential

Example: 2017-01-01T15:05:05Z

createdstring<date-time>

Creation timestamp

Example: 2017-01-01T15:05:05Z

authorstring<uuid>

ID of the user who originally authored the object

updatedstring<date-time>

Update timestamp

Example: 2017-01-01T15:05:05Z

updated_bystring<uuid>

ID of the user who updated the object

Example: eef4aefc-d64e-4c2c-aba4-4914c86ce059

]

]

users_search_response

{
  "count": 0,
  "items": [
    {
      "id": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "created": "2017-01-01T15:05:05Z",
      "updated": "2017-01-01T15:05:05Z",
      "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "comment": "A comment",
      "tags": [
        "string"
      ],
      "principal": "string",
      "distinguished_name": "string",
      "given_name": "string",
      "full_name": "string",
      "job_title": "string",
      "company": "string",
      "department": "string",
      "email": "string",
      "telephone": "string",
      "locale": "fi_FI",
      "attributes": [
        {
          "key": "aws_account",
          "value": "admin-bob"
        }
      ],
      "source": "string",
      "mfa": {
        "status": "ENABLED",
        "seed": {
          "seed_string": "string",
          "seed_qr_code": "string"
        }
      },
      "stale_access_token": true,
      "authorized_keys": [
        {
          "id": "2765b005-4ce1-4b2b-a9ca-ee6c4d6f2792",
          "username": "joe@privx.com",
          "user_id": "f2f448d8-0397-4894-982f-9a58a43921db",
          "source": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "work",
          "comment": "Joe's work laptop key",
          "public_key": "AAAAB3NzaC1yc2EAAAADAQABAAABAQDqoMogqErOw7lL3GD6Ez7Hv1FZBk0Iyk2pBFUhqb9sjY9IEw8P9OWFwLMhWQ4LNvekPAnmr03pMHSSP7Pw98+Izy0HxcHZGKcrDOIjnHF5Fog3w4rBYa6OxdcJRxctifx5szqmM4JkUNS1RJY5E4ns4xCgFV46Satph02M+eP9PXGh+ZecSNtdLoOovVuolEUdb8dINgto8zsjEuAQ+76qOEgAIuSsYlzGGZPyPnATtkUi/rK9fcAfbhSqSXNxFqf7wejEKwA1kFt8hSW2bUWJH268fqnejFwHjBTzjBw89dji6141ajAP8/Q2gZug0bb1U70PE4afE3fFh2VCfhwT",
          "not_before": "2020-07-31T17:32:28Z",
          "not_after": "2022-07-31T17:32:28Z",
          "expires_in": 0,
          "source_address": [
            "192.168.100.0/24"
          ],
          "fingerprints": [
            "SHA256:bdeYZ2qiEwCOCuf0oTvya/aH4Vo+nJLIauDKm/D8btM"
          ]
        }
      ],
      "webauthn_credentials": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "credential_id": "string",
          "name": "string",
          "comment": "string",
          "last_used": "2017-01-01T15:05:05Z",
          "created": "2017-01-01T15:05:05Z",
          "author": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "updated": "2017-01-01T15:05:05Z",
          "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059"
        }
      ]
    }
  ]
}