Current user

Make updates to the user to which the login token was issued.

Get profile

get

Retrieve the profile of the currently logged in user.

Authorizations

useraccessKey

AuthorizationstringRequired

Provide the token that is returned upon login

Responses

200

OK

application/json

401

unauthorized request

application/json

get

/me

HTTPcURLJavaScriptPython

GET /me HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "name": "text",
  "bio": "text",
  "activeSessions": 1,
  "createdAt": "2025-12-17T12:20:39.780Z",
  "updatedAt": "2025-12-17T12:20:39.780Z",
  "emails": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "email": "[email protected]",
      "verified": true,
      "passwordSet": true,
      "tokenSet": true,
      "createdAt": "2025-12-17T12:20:39.780Z",
      "updatedAt": "2025-12-17T12:20:39.780Z"
    }
  ],
  "defaultEmail": "text",
  "identities": [
    {
      "id": "text",
      "name": "text",
      "email": "text",
      "avatarUrl": "text",
      "provider": "text",
      "createdAt": "2025-12-17T12:20:39.780Z",
      "updatedAt": "2025-12-17T12:20:39.780Z"
    }
  ],
  "avatarUrl": "text",
  "phoneNumber": "text",
  "phoneNumbers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "phoneNumber": "text",
      "verified": true,
      "primary": true,
      "createdAt": "2025-12-17T12:20:39.780Z",
      "updatedAt": "2025-12-17T12:20:39.780Z"
    }
  ],
  "locale": "text",
  "timezone": "text",
  "badges": [
    "messagebird:cx"
  ],
  "userFraudInformation": {
    "score": 1,
    "userId": "text"
  }
}

Update profile

patch

Update the profile of the currently logged in user.

Authorizations

useraccessKey

AuthorizationstringRequired

Provide the token that is returned upon login

Body

application/json

namestringOptional

The display name for the user

biostringOptional

The user's description

avatarUrlstringOptional

URL to the user's profile picture.

localestring · locale-bcp47Optional

timezonestring · timezoneOptional

The default timezone for the user.

Responses

200

OK

application/json

422

Request validation failed

application/json

patch

/me

HTTPcURLJavaScriptPython

PATCH /me HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "name": "text",
  "bio": "text",
  "avatarUrl": "text",
  "locale": "text",
  "timezone": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "name": "text",
  "bio": "text",
  "activeSessions": 1,
  "createdAt": "2025-12-17T12:20:39.780Z",
  "updatedAt": "2025-12-17T12:20:39.780Z",
  "emails": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "email": "[email protected]",
      "verified": true,
      "passwordSet": true,
      "tokenSet": true,
      "createdAt": "2025-12-17T12:20:39.780Z",
      "updatedAt": "2025-12-17T12:20:39.780Z"
    }
  ],
  "defaultEmail": "text",
  "identities": [
    {
      "id": "text",
      "name": "text",
      "email": "text",
      "avatarUrl": "text",
      "provider": "text",
      "createdAt": "2025-12-17T12:20:39.780Z",
      "updatedAt": "2025-12-17T12:20:39.780Z"
    }
  ],
  "avatarUrl": "text",
  "phoneNumber": "text",
  "phoneNumbers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "phoneNumber": "text",
      "verified": true,
      "primary": true,
      "createdAt": "2025-12-17T12:20:39.780Z",
      "updatedAt": "2025-12-17T12:20:39.780Z"
    }
  ],
  "locale": "text",
  "timezone": "text",
  "badges": [
    "messagebird:cx"
  ],
  "userFraudInformation": {
    "score": 1,
    "userId": "text"
  }
}

Delete profile

delete

Delete the profile of the currently logged in user. Essentially deleting your account with the platform.

Authorizations

useraccessKey

AuthorizationstringRequired

Provide the token that is returned upon login

Responses

202

OK

delete

/me

HTTPcURLJavaScriptPython

DELETE /me HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

202

OK

No content