Your user

Your user is your representation as a human administrator on the platform. It can become a member of organizations and own spaces.

To learn how to authenticate using bearer tokens or how to manage your credentials and API keys, check the authentication section.

To learn how to review your usage records, check the usage section.

Access: Only you can manage your user.

Users must not be confused with identities, which represent the people speaking on the audios uploaded to the platform.

Fields

idstringrequired

The UUID of the user. Is unique.

Format: uuid

Example: 00000000-0000-0000-0000-000000000000

handlestringrequired

The handle of the user. Is unique.

Example: user-a

aliasstring | nullrequired

The alias of the user.

Example: User A

emailstringrequired

The email of the user. Is unique.

Example: user.a@email.com

emailVerifiedboolean

Indicates whether the email of the user has been verified.

Example: true

statestringrequired

The state of the user.

Format: UserState (string)

Possible values: [verified, unverified, blocked]

Example: verified

orgsintegerrequired

The number of organizations of the user.

Format: int32

Example: 10

spacesintegerrequired

The number of spaces of the user.

Format: int32

Example: 10

createdAtstringrequired

The date and time when the user was created.

Format: date-time

Example: 2023-01-01T00:00:00.000000Z

YourUser
{
  "id": "00000000-0000-0000-0000-000000000000",
  "handle": "user-a",
  "alias": "User A",
  "email": "user.a@email.com",
  "emailVerified": true,
  "state": "verified",
  "orgs": 10,
  "spaces": 10,
  "createdAt": "2023-01-01T00:00:00.000000Z"
}

Fields​

Fields