Get user details

Retrieves a user. Use 'me' as ID to get the current user.

get/users/{id}

Request

Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/users/{id}
Auth: one of:
- HTTP bearer
- API key in header X-Api-Key

Path parameters

idstring required

Example:1357158568008091264

ID of the user or 'me' for current user

Query parameters

subscribeboolean

Example:true

Whether to subscribe to real-time updates for this user (only for socket connections)

Response

User details retrieved successfully

Example response

{
  "item": {
    "id": "1357158568008091264",
    "email": "john.doe@example.com",
    "role": "admin",
    "name": "John Doe",
    "username": "john_doe",
    "avatar": {
      "url": "https://storage.example.com/user-avatars/1357158568008091264/original.jpg",
      "thumbnailUrls": {
        "cover180": "https://storage.example.com/user-avatars/1357158568008091264/cover-180.jpg"
      }
    },
    "gravatarUrl": "https://www.gravatar.com/avatar/abc123",
    "phone": "+1234567890",
    "organization": "Acme Corporation",
    "language": "en-US",
    "apiKeyPrefix": "D89VszVs",
    "subscribeToCardWhenCommenting": true,
    "enableFavoritesByDefault": true,
    "defaultEditorMode": "wysiwyg",
    "defaultHomeView": "groupedProjects",
    "defaultProjectsOrder": "byDefault",
    "lockedFieldNames": [
      "email",
      "password",
      "name"
    ],
    "createdAt": "2024-01-01T00:00:00.000Z",
    "updatedAt": "2024-01-01T00:00:00.000Z"
  },
  "included": {
    "notificationServices": [
      {
        "id": "1357158568008091264",
        "userId": "1357158568008091265",
        "boardId": "1357158568008091266",
        "url": "https://service.example.com/planka",
        "format": "text",
        "createdAt": "2024-01-01T00:00:00.000Z",
        "updatedAt": "2024-01-01T00:00:00.000Z"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.