ZynplexZPX Forgeby Zynplex
Para agentes.md

API

La API vive en https://zpxforge.com/api/v1. La especificación completa (OpenAPI) está en /api/v1/docs.

Autenticación

Hoy la API usa la sesión del navegador (cookie httpOnly). Las peticiones que cambian datos deben venir del propio sitio (cabecera Origin).

El CLI usa un token personal autorizado en el navegador para las rutas habilitadas. Las decisiones del cliente se realizan en su sesión web verificada.

Endpoints

Método y rutaQué hace
GET /v1/healthSalud de la plataforma (base de datos, Redis, worker)
GET /v1/meLa persona, sus empresas e invitaciones pendientes
GET /v1/rolesRoles disponibles
POST /v1/orgsRegistra una empresa
GET /v1/orgs/{empresa}Empresa, tu rol y tus permisos
GET /v1/orgs/{empresa}/membersMiembros
PATCH /v1/orgs/{empresa}/members/{id}Cambia el rol de un miembro
POST /v1/orgs/{empresa}/invitationsInvita por correo
GET /v1/orgs/{empresa}/projectsProyectos
POST /v1/orgs/{empresa}/projectsCrea un proyecto
PUT /v1/orgs/{empresa}/projects/{p}/roles/{id}Rol de una persona en un proyecto
GET /v1/orgs/{empresa}/githubInstalaciones y repos de GitHub
POST /v1/orgs/{empresa}/projects/{p}/reposConecta un repo al proyecto
POST /v1/orgs/{empresa}/projects/{p}/repos/{id}/protectProtege develop y main
GET /v1/orgs/{empresa}/auditAuditoría (solo admins)

Errores

{ "detail": "Tu rol no permite esta acción", "code": "forbidden" }
Código HTTPSignificado
401Falta iniciar sesión
403Sin permiso, empresa inactiva u origen no permitido
404No existe o no perteneces a esa empresa
409Conflicto (por ejemplo, el último admin)
429Demasiados intentos