---
title: "Get workspace user"
method: GET
path: "/api/v1/workspaces/users/{userId}"
tags: ["workspace", "users"]
---

# Get workspace user

`GET /api/v1/workspaces/users/{userId}`

Retrieve details for a specific user in the current workspace by user ID.

    This endpoint returns all metadata for the user, excluding workspace references.

    **Use cases:**
    - Displaying user profiles
    - Managing user roles and permissions
    - Auditing user activity

## Path parameters

- `userId` string, required

## Response `200`

This response returns the metadata for the requested workspace user.

- object — This response returns the metadata for the requested workspace user.
  - `isInitialized` boolean
  - `created` string, date-time, required
  - `uid` string, required
  - `id` string, required
  - `picture` string, uri, required
  - `email` string, email, required
  - `name` string, required
  - `updated` string, date-time, required
  - `workspaceTeams` object, required
  - `subscriptionStatus` string
  - `lastActive` string, date-time
  - `lastActiveRefreshedAt` string, date-time
  - `preferences` object
    - `ossAutoRedirect` boolean
    - `sceneOrder` 'manual' | 'created' | 'updated' | 'name'
    - `initialRedirect` 'dashboard' | 'lastEditedScene' | 'lastVisitedScene' | 'privateCollection'
    - `hideDeprecatedFonts` boolean
    - `enableAutoSceneNamingForPrivateCollections` boolean
    - `blockCommentEmailNotifications` boolean
  - `lastVisitedScenes` string[]
  - `lastEditedScenes` string[]
  - `rateLimits` object
    - `textToDiagram` object
    - `diagramToCode` object
    - `nameScene` object
  - `libraryVersion` number
  - `role` 'member' | 'admin', required

## Other responses

- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.

---

[API](https://skmtc.net/excalidraw/apis/excalidraw-api.md) · [All operations](https://skmtc.net/excalidraw/apis/excalidraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/excalidraw/excalidraw-api/revisions/c1404d1545ba/schema)