Organizations API
Manage organization details, team members, and role assignments programmatically.
Get Organization Details
GET
/organizations/{org_id}Description
Retrieves the profile details, status, and subscription tier of a specific organization.
Permissions
Requires Admin or Manager role.
Request
No request body required.
Response
{
"id": "org_123456",
"name": "Acme Corp",
"industry": "Real Estate",
"status": "active",
"created_at": "2026-01-15T10:30:00Z"
}
Error Codes
401 Unauthorized- Missing or invalid API key.403 Forbidden- Insufficient permissions to access this organization.404 Not Found- Organization ID does not exist.
List Team Members
GET
/organizations/{org_id}/membersDescription
Returns a list of all users invited to the organization and their current RBAC roles.
Permissions
Requires Admin role.
Request
No request body required.
Response
{
"data": [
{
"user_id": "usr_987",
"email": "admin@acme.com",
"role": "admin",
"status": "active"
},
{
"user_id": "usr_654",
"email": "manager@acme.com",
"role": "manager",
"status": "pending_invite"
}
],
"total": 2
}