We use cookies to improve your experience, analyze site traffic and measure how our Google ads perform. By clicking "Accept", you consent to analytics and advertising cookies. See our Privacy Policy for details.

Happy Thanksgiving - 15% off every paid plan Use code THANKYOU at checkout. Ends 30 November.See plans

API de Equipos

Gestiona los miembros del equipo de tu organizacion. Invita colaboradores, asigna roles, actualiza permisos y elimina miembros.

On this page

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

owner

Acceso completo

Acceso completo

Acceso completo

Acceso completo

admin

Acceso completo

Acceso completo

Invitar, eliminar, cambiar roles

Solo lectura

editor

Crear, editar, publicar, archivar

Solo lectura

Sin acceso

Sin acceso

viewer

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

email

string

Si

Direccion de email de la persona a invitar

name

string

Si

Nombre para mostrar del miembro invitado

role

string

Si

Rol a asignar: admin, editor, viewer

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

token

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

token

string

Si

Token de invitacion

password

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

role

string

Si

Nuevo rol: admin, editor, viewer

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 admin no puede promover a otro miembro a owner.

  • 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 owner de 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.

← Previous
API de Publicaciones