members-access

Get workspace member

Changed on

Plan: Business or higher

Scope: workspaces:read

Returns an active workspace member's profile and join and invitation dates. name is the stored display name, or null when unavailable. Pass the public user UUID returned as user_id by GET /v1/workspaces/{workspace_id}/members. Unknown users and missing or non-active memberships return 404. Reads are eventually consistent: recent changes may not appear immediately. Retry the read with backoff if an expected change is missing.

get/v1/workspaces/{workspace_id}/members/{user_id}

Request

  • Base URL
    https://api.lovable.dev
  • Auth
    • API key in header Lovable-API-Key
    • or HTTP bearer

Path parameters

workspace_idstring required

Workspace ID.

Example:workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
user_idstring uuid required

User ID returned by the workspace members endpoint.

Example:404666c6-b533-5d2c-9768-c425bf40559b

Public user UUID returned as user_id by the workspace members endpoint.

Headers

Lovable-Versionstring

Stable API version to serve, as a YYYY-MM-DD date. Omit for the oldest supported stable version, currently 2026-09-11.

Lovable-Betastring

Comma-separated beta revision strings to enable on top of the stable version.

Response

OK

emailstring nullable required

Member email address; null when unavailable.

namestring nullable required

Member display name in this workspace; null when unavailable.

role'workspace_owner' | 'workspace_admin' | 'workspace_editor' | 'workspace_viewer' | 'external_collaborator' required

Workspace access role, with the same values as the member list. external_collaborator identifies a user with access to specific projects, rather than workspace membership. More values may be added; clients must tolerate unknown values.

type'user' required

Identity type. Currently user; clients must tolerate unknown values.

user_idstring uuid required

Public user UUID for this member.

workspace_idstring required

Workspace the membership belongs to.

Example response

{
  "email": "member@example.com",
  "name": "Example Member",
  "role": "workspace_admin",
  "type": "user",
  "user_id": "404666c6-b533-5d2c-9768-c425bf40559b",
  "workspace_id": "workspace_01jw3k9m2xq8r5v0c7d4e6f2gh"
}

Changes