Viewer, Commenter, Editor, Admin, Owner.
Solicitud básica y respuesta
Lista miembros actuales conGET /api/v1/app/project/{projectId}/member.
Parametros del endpoint
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" \
-H "Authorization: Bearer {API_TOKEN}"
-H "x-org: {org_slug}"
Ejemplo de respuesta
Ejemplo de respuesta
{
"data": [
{
"id": "member_1a2b3c4d5e6f",
"role": "Owner",
"user": {
"id": "user_4b7c2a1d9e5f3c8b",
"org_id": "org_2f3a9d1c7b5e4a8f",
"account_id": "acct_6c8a1f3b2d4e5f7a",
"name": "Sasha Patel",
"email": "sasha@auroralabs.com",
"state": "Active",
"roles": ["AppAdmin"],
"created_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
Parametros del endpoint
| Tipo | Nombre | Requerido | Notas |
|---|---|---|---|
| Path | projectID | Si | Identificador del proyecto. |
| Body | members | Si | Lista de miembros a agregar. |
| Body | members[].user_id | Si | Identificador del usuario. |
| 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": [
{ "user_id": "{userID}", "role": "Editor" }
]
}'
Ejemplo de respuesta
Ejemplo de respuesta
[
{
"id": "member_7f6e5d4c3b2a",
"role": "Editor",
"user": {
"id": "user_9d1c3b5a7f2e4c6d",
"org_id": "org_2f3a9d1c7b5e4a8f",
"account_id": "acct_6c8a1f3b2d4e5f7a",
"name": "Jordan Lee",
"email": "jordan@auroralabs.com",
"state": "Active",
"roles": ["AppMember"],
"created_at": "2026-02-07T09:20:12Z"
},
"is_project_member": true
}
]
Actualizar roles de miembros
Parametros del endpoint
Parametros del endpoint
| Tipo | Nombre | Requerido | Notas |
|---|---|---|---|
| Path | projectID | Si | Identificador del proyecto. |
| Body | members | Si | Lista de miembros a actualizar. |
| Body | members[].user_id | Si | Identificador del usuario. |
| 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": [
{ "user_id": "{userID}", "role": "Admin", "is_pinned": true }
]
}'
Ejemplo de respuesta
Ejemplo de respuesta
[
{
"id": "member_7f6e5d4c3b2a",
"role": "Admin",
"user": {
"id": "user_9d1c3b5a7f2e4c6d",
"org_id": "org_2f3a9d1c7b5e4a8f",
"account_id": "acct_6c8a1f3b2d4e5f7a",
"name": "Jordan Lee",
"email": "jordan@auroralabs.com",
"state": "Active",
"roles": ["AppMember"],
"created_at": "2026-02-07T09:20:12Z"
},
"is_project_member": true
}
]
Obtener o quitar un miembro
- Obtener miembro
- Eliminar miembro
curl "https://{BASE_URL}/api/v1/app/project/{projectID}/member/{userID}" \
-H "Authorization: Bearer {API_TOKEN}"
-H "x-org: {org_slug}"
Ejemplo de respuesta
Ejemplo de respuesta
{
"id": "member_7f6e5d4c3b2a",
"role": "Admin",
"user": {
"id": "user_9d1c3b5a7f2e4c6d",
"org_id": "org_2f3a9d1c7b5e4a8f",
"account_id": "acct_6c8a1f3b2d4e5f7a",
"name": "Jordan Lee",
"email": "jordan@auroralabs.com",
"state": "Active",
"roles": ["AppMember"],
"created_at": "2026-02-07T09:20:12Z"
},
"is_project_member": true
}
curl -X DELETE "https://{BASE_URL}/api/v1/app/project/{projectID}/member/{userID}" \
-H "Authorization: Bearer {API_TOKEN}"
-H "x-org: {org_slug}"
Ejemplo de respuesta
Ejemplo de respuesta
{
"id": "member_7f6e5d4c3b2a",
"role": "Admin",
"user": {
"id": "user_9d1c3b5a7f2e4c6d",
"name": "Jordan Lee",
"email": "jordan@auroralabs.com",
"state": "Active",
"roles": ["AppMember"],
"created_at": "2026-02-07T09:20:12Z"
},
"is_project_member": false
}
Errores y casos límite
- 403: no tienes permisos para administrar miembros.
- 404: proyecto o usuario no encontrado.