Skip to main content
GET
Get a user by ID

Overview

The Users API returns the workspace details associated with your API key — useful when you need to display the active org/role in your UI, or when you’re building a multi-tenant integration where users connect different WaterrAI workspaces.
You don’t need to fetch this before calling other endpoints. Your membership_id and org_id are inferred from your API key on every request — meetings, scenarios, personas, etc. are created in the right workspace automatically.

Get Active Workspace

Retrieve the workspace and membership context attached to your API key.

Response Fields

Get User by ID

Retrieve a user’s public profile by their user ID. No authentication required.
string
required
The user UUID

Get User by Username

Look up a user by their username. No authentication required. Useful for building public profile pages or resolving usernames to IDs.
string
required
The username

Authorizations

Authorization
string
header
required

API key from waterr.ai/settings?tab=api-keys. Send as Authorization: Bearer wai_<your_key>.

Path Parameters

userId
string
required

Response

User details