4 months ago

Feature: add Partner Api - find user by email

Partner API — Find User by Email
A new Partner API endpoint lets partners search for any user account by email address — returning the user's workspace memberships, workspace IDs, and roles across all workspaces they belong to.
New Endpoint
MethodEndpointDescriptionGET | /partner/find-user-by-email | Find user by email address
Parameters
NameTypeRequiredDescriptionemail | string (query) | ✅ Yes | Email address to search for
limit | integer ($int64, query) | No | Number of items in the response
page | integer ($int64, query) | No | Page number, between 1 and 100
Response Example
{
  "data": [
    {
      "user_id": 0,
      "workspace_id": 0,
      "workspace_name": "string",
      "role": "string"
    }
  ]
}
Error (400):
{ "message": "Error message" }
What's New
  • 🔍 Search for any user by email via Partner API — look up account details and workspace memberships in one call
  • 📋 Returns user_id, workspace_id, workspace_name, and role for every workspace the user belongs to
  • 📄 Supports pagination via limit and page parameters (up to page 100)
  • 🔑 Requires Manage Team scope on your Partner API token
How to Use
  1. Authenticate with your Partner API key (Manage Team scope required)
  2. Call GET /partner/find-user-by-email?email=user@example.com
  3. Optionally add &limit=20&page=1 for paginated results
  4. Parse the data array to see which workspaces the user is a member of and their role in each
Why It Matters
  • Enables partners to audit user workspace access across all client accounts programmatically
  • Useful for support workflows — quickly locate which workspaces a user belongs to by email without manual UI searching
  • Supports account management automation, such as cross-workspace user deprovisioning or role auditing
👉 Partner-only feature. Requires Manage Team scope. Published: February 12, 2026