Miembros del proyecto

Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.

Los campos de miembros de proyecto y las respuestas de cuenta cambian en 1.58. Consulta Migración de API 1.57 → 1.58 antes de actualizar tu integración.

Usa estos endpoints para controlar quién puede acceder a un proyecto y qué rol tiene. Roles: Viewer, Commenter, Editor, Admin, Owner. Las respuestas de miembro del proyecto usan el ID del miembro del espacio de trabajo en id e incluyen la cuenta relacionada en account.

Solicitud básica y respuesta

Lista miembros actuales con GET /api/v1/app/project/{projectId}/member.

Parametros del endpoint

Tipo	Nombre	Requerido	Notas
Path	`projectID`	Si	Identificador del proyecto.
Query	`page`	No	Numero absoluto de pagina, empezando en 1.
Query	`page_size`	No	Numero de elementos por pagina. Predeterminado `20`.
Query	`page_order`	No	`ASC` o `DESC`. Predeterminado `ASC`.
Query	`after`	No	Cursor o valor desde el que paginar hacia delante.
Query	`before`	No	Cursor o valor desde el que paginar hacia atras.
Query	`first`	No	Limita a los primeros N elementos tras un cursor.
Query	`last`	No	Limita a los ultimos N elementos antes de un cursor.
Query	`total_count`	No	Incluye el total en la respuesta.

curl "https://{BASE_URL}/api/v1/app/project/{projectID}/member?page=1&page_size=50&total_count=true" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "data": [
    {
      "id": "{wsMemberId}",
      "role": "Owner",
      "account": {
        "id": "{accountId}",
        "state": "Active",
        "email": "sasha@example.com",
        "name": "Sasha Patel",
        "profile_picture": "https://{BASE_URL}/files/profile-picture.png",
        "provider": "Credentials",
        "roles": ["Workspace"],
        "created_at": "2026-01-10T09:00:00Z",
        "updated_at": "2026-02-08T14:12:45Z"
      },
      "is_project_member": true
    }
  ],
  "has_next_page": false,
  "has_previous_page": false,
  "total_count": 1
}

Agregar miembros

Parametros del endpoint

Tipo	Nombre	Requerido	Notas
Path	`projectID`	Si	Identificador del proyecto.
Body	`members`	Si	Lista de miembros a agregar.
Body	`members[].ws_member_id`	Si	Identificador del miembro del espacio de trabajo.
Body	`members[].role`	Si	`Viewer`, `Commenter`, `Editor`, `Admin` u `Owner`.

curl -X POST "https://{BASE_URL}/api/v1/app/project/{projectID}/member" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "members": [
      { "ws_member_id": "{wsMemberId}", "role": "Editor" }
    ]
  }'

Ejemplo de respuesta

[
  {
    "id": "{wsMemberId}",
    "role": "Editor",
    "account": {
      "id": "{accountId}",
      "state": "Active",
      "email": "jordan@example.com",
      "name": "Jordan Lee",
      "profile_picture": "https://{BASE_URL}/files/profile-picture.png",
      "provider": "Credentials",
      "roles": ["Workspace"],
      "created_at": "2026-01-10T09:00:00Z",
      "updated_at": "2026-02-07T09:20:12Z"
    },
    "is_project_member": true
  }
]

Actualizar roles de miembros

Parametros del endpoint

Tipo	Nombre	Requerido	Notas
Path	`projectID`	Si	Identificador del proyecto.
Body	`members`	Si	Lista de miembros a actualizar.
Body	`members[].ws_member_id`	Si	Identificador del miembro del espacio de trabajo.
Body	`members[].role`	No	`Viewer`, `Commenter`, `Editor`, `Admin` u `Owner`.
Body	`members[].is_pinned`	No	Fija o desfija el proyecto para ese miembro.

curl -X PUT "https://{BASE_URL}/api/v1/app/project/{projectID}/member" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "members": [
      { "ws_member_id": "{wsMemberId}", "role": "Admin", "is_pinned": true }
    ]
  }'

Ejemplo de respuesta

[
  {
    "id": "{wsMemberId}",
    "role": "Admin",
    "account": {
      "id": "{accountId}",
      "state": "Active",
      "email": "jordan@example.com",
      "name": "Jordan Lee",
      "profile_picture": "https://{BASE_URL}/files/profile-picture.png",
      "provider": "Credentials",
      "roles": ["Workspace"],
      "created_at": "2026-01-10T09:00:00Z",
      "updated_at": "2026-02-07T09:20:12Z"
    },
    "is_project_member": true
  }
]

Obtener o quitar un miembro

Usa me en lugar de wsMemberId para dirigirte al miembro autenticado del espacio de trabajo.

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Path	`projectID`	Si	Identificador del proyecto.
Path	`wsMemberId`	Si	ID del miembro, o `me` para el miembro autenticado.

Obtener miembro
Eliminar miembro

curl "https://{BASE_URL}/api/v1/app/project/{projectID}/member/{wsMemberId}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "id": "{wsMemberId}",
  "role": "Admin",
  "account": {
    "id": "{accountId}",
    "state": "Active",
    "email": "jordan@example.com",
    "name": "Jordan Lee",
    "profile_picture": "https://{BASE_URL}/files/profile-picture.png",
    "provider": "Credentials",
    "roles": ["Workspace"],
    "created_at": "2026-01-10T09:00:00Z",
    "updated_at": "2026-02-07T09:20:12Z"
  },
  "is_project_member": true
}

curl -X DELETE "https://{BASE_URL}/api/v1/app/project/{projectID}/member/{wsMemberId}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "id": "{wsMemberId}",
  "role": "Admin",
  "account": {
    "id": "{accountId}",
    "state": "Active",
    "email": "jordan@example.com",
    "name": "Jordan Lee",
    "profile_picture": "https://{BASE_URL}/files/profile-picture.png",
    "provider": "Credentials",
    "roles": ["Workspace"],
    "created_at": "2026-01-10T09:00:00Z",
    "updated_at": "2026-02-07T09:20:12Z"
  },
  "is_project_member": true
}

Errores y casos límite

403: no tienes permisos para administrar miembros.
404: proyecto o miembro del espacio de trabajo no encontrado.

Primeros pasos

Construye con Zylon

Coding Agents

Miembros del proyecto

Solicitud básica y respuesta

Agregar miembros

Actualizar roles de miembros

Obtener o quitar un miembro

Errores y casos límite

​Solicitud básica y respuesta

​Agregar miembros

​Actualizar roles de miembros

​Obtener o quitar un miembro

​Errores y casos límite

Solicitud básica y respuesta

Agregar miembros

Actualizar roles de miembros

Obtener o quitar un miembro

Errores y casos límite