User

Read a user by ID.

get/user/{id}

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/user/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the user you want to get information about.

Response

The operation was successful.

idinteger required

The ID of the user.

emailstring required

The email of the user.

first_namestring nullable required

The first name of the user.

last_namestring nullable required

The last name of the user.

organization_idinteger required

The organization ID of the user.

status'active' | 'inactive' | 'pending' | 'invited'

The status of the user.

avatarstring nullable

The avatar of the user.

type'person' | 'machine'

The type of the user.

provider'cognito' | 'saml' nullable

The authentication provider of the user.

nrnstring required

The NRN of the user.

send_inviteboolean

Whether to send an invite email to the user.

metadataobject

The metadata of the user.

Example response

{
  "id": 123456,
  "email": "alex.mgr@crypto-inc.com",
  "first_name": "Alex",
  "last_name": "Doe",
  "organization_id": 1234,
  "status": "active",
  "avatar": "https://my-avatar-url.com",
  "type": "person",
  "provider": "cognito",
  "nrn": "organization=123",
  "send_invite": true,
  "metadata": {
    "key": "value"
  }
}

Changes

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property message deprecated

    • info

      response property message deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status