API de Equipos
Gestiona los miembros del equipo de tu organizacion. Invita colaboradores, asigna roles, actualiza permisos y elimina miembros.
- Roles y Permisos
- Listar Miembros del Equipo
- Ejemplo de Solicitud
- Ejemplo de Respuesta
- Invitar a un Miembro del Equipo
- Cuerpo de la Solicitud
- Ejemplo de Solicitud
- Ejemplo de Respuesta
- Reenviar Invitacion
- Ejemplo de Solicitud
- Ejemplo de Respuesta
- Revocar Invitacion
- Ejemplo de Solicitud
- Ejemplo de Respuesta
- Validar una Invitacion (Publico)
- Cuerpo de la Solicitud
- Ejemplo de Respuesta
- Aceptar una Invitacion (Publico)
- Cuerpo de la Solicitud
- Ejemplo de Solicitud
- Ejemplo de Respuesta
- Actualizar Rol de Miembro
- Cuerpo de la Solicitud
- Ejemplo de Solicitud
- Ejemplo de Respuesta
- Eliminar un Miembro del Equipo
- Ejemplo de Solicitud
- Ejemplo de Respuesta
- Limites del Plan
API de Equipos
La API de Equipos te permite gestionar los miembros de tu organizacion. Puedes invitar nuevos colaboradores, asignar roles, actualizar permisos y eliminar miembros. Los limites de miembros del equipo se aplican segun tu plan de suscripcion.
URL base: https://api.zenflip.io/v1/teams
Roles y Permisos
ZenFlip utiliza cuatro roles con permisos jerarquicos:
Rol | Publicaciones | Configuracion | Gestion de Equipo | Facturacion |
|---|---|---|---|---|
| Acceso completo | Acceso completo | Acceso completo | Acceso completo |
| Acceso completo | Acceso completo | Invitar, eliminar, cambiar roles | Solo lectura |
| Crear, editar, publicar, archivar | Solo lectura | Sin acceso | Sin acceso |
| Solo lectura | Sin acceso | Sin acceso | Sin acceso |
Cada organizacion tiene exactamente un owner. El rol de propietario no puede ser eliminado ni degradado. La transferencia de propiedad debe realizarse a traves del panel de control.
Listar Miembros del Equipo
Obtiene todos los miembros de tu organizacion.
` GET /teams/members `
Ejemplo de Solicitud
`bash curl "https://api.zenflip.io/v1/teams/members" \ -H "Authorization: Bearer YOUR_TOKEN" `
Ejemplo de Respuesta
`json { "data": [ { "id": "550e8400-e29b-41d4-a716-446655440000", "email": "owner@example.com", "name": "Alex Chen", "role": "owner", "status": "active", "avatarUrl": "https://cdn.zenflip.io/avatars/550e8400.jpg", "emailVerified": true, "lastActiveAt": "2026-02-20T14:00:00.000Z", "createdAt": "2025-06-01T10:00:00.000Z" }, { "id": "660e8400-e29b-41d4-a716-446655440001", "email": "editor@example.com", "name": "Sarah Kim", "role": "editor", "status": "active", "avatarUrl": null, "emailVerified": true, "lastActiveAt": "2026-02-19T16:30:00.000Z", "createdAt": "2025-09-15T08:00:00.000Z" }, { "id": "770e8400-e29b-41d4-a716-446655440002", "email": "newuser@example.com", "name": "Pending User", "role": "viewer", "status": "invited", "avatarUrl": null, "emailVerified": false, "lastActiveAt": null, "createdAt": "2026-02-18T11:00:00.000Z" } ] } `
El campo status indica si el miembro esta active (acepto la invitacion) o invited (pendiente de aceptacion).
Invitar a un Miembro del Equipo
Envia una invitacion por email a un nuevo miembro del equipo. El invitado recibe un enlace para establecer su contrasena y unirse a la organizacion.
` POST /teams/invite `
Rol requerido: admin o superior.
Cuerpo de la Solicitud
Campo | Tipo | Requerido | Descripcion |
|---|---|---|---|
| string | Si | Direccion de email de la persona a invitar |
| string | Si | Nombre para mostrar del miembro invitado |
| string | Si | Rol a asignar: |
Ejemplo de Solicitud
`bash curl -X POST "https://api.zenflip.io/v1/teams/invite" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "email": "neweditor@example.com", "name": "Jordan Lee", "role": "editor" }' `
Ejemplo de Respuesta
`json { "data": { "id": "880e8400-e29b-41d4-a716-446655440003", "email": "neweditor@example.com", "name": "Jordan Lee", "role": "editor", "status": "invited", "createdAt": "2026-02-20T16:00:00.000Z" } } `
Si la organizacion ha alcanzado el limite de miembros del equipo de su plan, la API devuelve un error 403 con un mensaje indicando que se ha alcanzado el limite.
Reenviar Invitacion
Reenvia el email de invitacion a un miembro del equipo pendiente.
` POST /teams/members/:id/resend-invite `
Rol requerido: admin o superior.
Ejemplo de Solicitud
`bash curl -X POST "https://api.zenflip.io/v1/teams/members/880e8400.../resend-invite" \ -H "Authorization: Bearer YOUR_TOKEN" `
Ejemplo de Respuesta
`json { "message": "Invitation resent" } `
Revocar Invitacion
Cancela una invitacion pendiente antes de que haya sido aceptada.
` DELETE /teams/members/:id/revoke-invite `
Rol requerido: admin o superior.
Ejemplo de Solicitud
`bash curl -X DELETE "https://api.zenflip.io/v1/teams/members/880e8400.../revoke-invite" \ -H "Authorization: Bearer YOUR_TOKEN" `
Ejemplo de Respuesta
`json { "message": "Invitation revoked" } `
Validar una Invitacion (Publico)
Verifica si un token de invitacion es valido sin consumirlo. Este es un endpoint publico utilizado por el frontend para mostrar el formulario de aceptacion de la invitacion.
` POST /teams/validate-invite `
No se requiere autenticacion.
Cuerpo de la Solicitud
Campo | Tipo | Requerido | Descripcion |
|---|---|---|---|
| string | Si | Token de invitacion |
Ejemplo de Respuesta
`json { "data": { "valid": true, "email": "neweditor@example.com", "organizationName": "Acme Publishing", "role": "editor", "invitedBy": "Alex Chen" } } `
Aceptar una Invitacion (Publico)
Acepta una invitacion y establece una contrasena. Este endpoint crea la cuenta de usuario, genera tokens JWT e inicia sesion del usuario inmediatamente.
` POST /teams/accept-invite `
No se requiere autenticacion.
Cuerpo de la Solicitud
Campo | Tipo | Requerido | Descripcion |
|---|---|---|---|
| string | Si | Token de invitacion |
| string | Si | Contrasena para la cuenta |
Ejemplo de Solicitud
`bash curl -X POST "https://api.zenflip.io/v1/teams/accept-invite" \ -H "Content-Type: application/json" \ -d '{ "token": "invite_token_abc123", "password": "SecureP@ssw0rd!" }' `
Ejemplo de Respuesta
`json { "message": "Invitation accepted successfully", "user": { "id": "880e8400-e29b-41d4-a716-446655440003", "email": "neweditor@example.com", "name": "Jordan Lee", "role": "editor" }, "organization": { "id": "660e8400-e29b-41d4-a716-446655440000", "name": "Acme Publishing" }, "accessToken": "eyJhbGciOiJIUzI1NiIs...", "refreshToken": "eyJhbGciOiJIUzI1NiIs...", "expiresIn": 3600 } `
Actualizar Rol de Miembro
Cambia el rol de un miembro del equipo existente.
` PATCH /teams/members/:id/role `
Rol requerido: admin o superior.
Cuerpo de la Solicitud
Campo | Tipo | Requerido | Descripcion |
|---|---|---|---|
| string | Si | Nuevo rol: |
Ejemplo de Solicitud
`bash curl -X PATCH "https://api.zenflip.io/v1/teams/members/660e8400.../role" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "role": "admin" }' `
Ejemplo de Respuesta
`json { "data": { "id": "660e8400-e29b-41d4-a716-446655440001", "email": "editor@example.com", "name": "Sarah Kim", "role": "admin", "status": "active" } } `
Restricciones:
No puedes cambiar el rol de
owner.Un
adminno puede promover a otro miembro aowner.No puedes cambiar tu propio rol.
Eliminar un Miembro del Equipo
Elimina a un miembro de la organizacion. Esto revoca todos sus accesos inmediatamente.
` DELETE /teams/members/:id `
Rol requerido: admin o superior.
Ejemplo de Solicitud
`bash curl -X DELETE "https://api.zenflip.io/v1/teams/members/660e8400-e29b-41d4-a716-446655440001" \ -H "Authorization: Bearer YOUR_TOKEN" `
Ejemplo de Respuesta
`json { "message": "Team member removed" } `
Restricciones:
El
ownerde la organizacion no puede ser eliminado.Un miembro no puede eliminarse a si mismo (usa el panel de control para abandonar una organizacion).
Limites del Plan
Los limites de miembros del equipo varian segun el plan de suscripcion:
Plan | Miembros del Equipo |
|---|---|
Explorer | 1 (solo propietario) |
Creator | 3 |
Business | 15 |
Enterprise | Ilimitado |
Intentar invitar a un miembro mas alla del limite de tu plan devuelve un error 403. Actualiza tu plan a traves de la configuracion de facturacion para aumentar el limite.