get__organization_users_{userId}

GET /organization/users/{userId}

Get Organization User

Retrieve details for a specific user in the authenticated user's organization. This endpoint requires user management permissions (WORKSPACES role or higher) and both users must be in the same organization.

Path Parameters

Name	Type	Required	Description
» userId	string	true	Unique identifier of the user to retrieve

TypeScript Client Library

// Using the Flashback TypeScript client
import { FlashbackClient } from '@flashback/client';

const client = new FlashbackClient({
  accessToken: 'your-access-token'
});

// Get a specific organization user
try {
  const result = await client.organization.users.get('user-id');
  console.log('User details:', result);
} catch (error) {
  console.error('Failed to retrieve user:', error);
}

Code Samples

Shell

# You can also use wget
curl -X GET https://backend.flashback.tech/organization/users/550e8400-e29b-41d4-a716-446655440000 \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

HTTP

JavaScript

Ruby

Python

PHP

Java

Go

Example responses

200 Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "[email protected]",
  "name": "John",
  "lastName": "Doe",
  "orgId": "123e4567-e89b-12d3-a456-426614174000",
  "orgRole": 2,
  "validated": true,
  "deletedAt": null,
  "orgRoleDescription": "WORKSPACES",
  "orgRoles": [0, 1, 2]
}

403 Response

{
  "success": false,
  "message": "Insufficient permissions to view users"
}

404 Response

{
  "success": false,
  "message": "User not found"
}

500 Response

{
  "success": false,
  "message": "Internal server error"
}

Responses

Status	Meaning	Description	Schema
200	OK	User retrieved successfully	Inline
403	Forbidden	Insufficient permissions or users not in same organization	Inline
404	Not Found	User not found	Inline
500	Internal Server Error	Internal server error	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» id	string	false	none	Unique identifier for the user
» email	string	false	none	User's email address
» name	string	false	none	User's first name
» lastName	string	false	none	User's last name
» orgId	string	false	none	Organization identifier
» orgRole	integer	false	none	User's organization role (0x00-0xff)
» validated	boolean	false	none	Whether the user's email is validated
» deletedAt	string (date-time)	false	none	Deletion timestamp (null if active)
» orgRoleDescription	string	false	none	Human-readable role description
» orgRoles	[integer]	false	none	Array of available roles for the user

Status Code 403

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» message	string	false	none	Error message describing the permission issue

Status Code 404

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» message	string	false	none	Error message describing the issue

Status Code 500

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» message	string	false	none	Error message describing the server issue

Enumerated Values

Parameter	Value	Description
» orgRole	0x00	USER - Default role with basic access
» orgRole	0x01	BILLING - Can manage billing and subscriptions
» orgRole	0x02	WORKSPACES - Can manage workspaces and team members
» orgRole	0xfe	ADMINISTRATOR - Administrative access
» orgRole	0xff	OWNER - Full organization access

Security

• BearerAuth: Bearer token authentication required

• Permissions: Requires WORKSPACES role or higher to access user management functions

• Organization Access: Both users must be in the same organization

Notes

• This endpoint returns the user object directly on success (not wrapped in a response object)

• Error responses follow the standard error format with success: false and a message field

• Users can only view other users within their own organization