Organizaciones

Listar organizaciones

GET /api/v1/organizations

Devuelve todas las organizaciones a las que pertenece el usuario autenticado.

Respuesta

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

Valores de los roles

Rol	Descripción
OWNER	Acceso completo, puede transferir o eliminar la organización
ADMIN	Administrar miembros, carpetas y todas las grabaciones
EDITOR	Crear y administrar grabaciones propias
VIEWER	Acceso de solo lectura

---

Listar carpetas

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

Devuelve todas las carpetas activas de la organización. El usuario autenticado debe ser miembro.

Respuesta

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

---

Listar miembros

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

Devuelve todos los miembros de la organización. El usuario autenticado debe ser miembro.

Respuesta

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

Códigos de error

Código	Estado HTTP	Significado
FORBIDDEN	403	El usuario no es miembro de esta organización
ORGANIZATION_NOT_FOUND	404	La organización no existe