Organizations

List organizations

GET /api/v1/organizations

Returns all organizations the authenticated user belongs to.

Response

{
  "data": [
    {
      "id": "org_uuid",
      "name": "Acme Inc.",
      "role": "ADMIN",
      "member_count": 12
    }
  ]
}

Role values

Role	Description
OWNER	Full access, can transfer or delete the organization
ADMIN	Manage members, folders, and all recordings
EDITOR	Create and manage own recordings
VIEWER	Read-only access

---

List folders

GET /api/v1/organizations/:id/folders

Returns all active folders in the organization. The authenticated user must be a member.

Response

{
  "data": [
    {
      "id": "folder_uuid",
      "name": "Product team"
    }
  ]
}

---

List members

GET /api/v1/organizations/:id/members

Returns all members of the organization. The authenticated user must be a member.

Response

{
  "data": [
    {
      "id": "user_uuid",
      "email": "alice@example.com",
      "name": "Alice",
      "role": "EDITOR"
    }
  ]
}

Error codes

Code	HTTP Status	Meaning
FORBIDDEN	403	User is not a member of this organization
ORGANIZATION_NOT_FOUND	404	Organization does not exist