DocumentaciónReferencia de la API
Miembros
Los miembros del espacio, sus roles y las invitaciones.
Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).
| Operación | Llamada | |
|---|---|---|
| Listar los miembros | GET /workspace/members | Gratis |
| Listar las invitaciones | GET /workspace/invitations | Gratis |
| Invitar a un miembro | POST /workspace/invitations | Gratis |
| Cancelar una invitación | DELETE /workspace/invitations/{invitationId} | Gratis |
| Modificar un miembro | PATCH /workspace/members/{userId} | Gratis |
| Quitar a un miembro | DELETE /workspace/members/{userId} | Gratis |
Listar los miembros
/workspace/membersGratisLos miembros del espacio y su rol.
Herramienta MCP list_members
curl https://app.semchat.io/api/v1/workspace/members \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"user_id": "01995d03-8ea0-7e30-9bc8-4a6a79a79b4f",
"name": "Olivia Owner",
"email": "owner@example.com",
"role": "owner",
"joined_at": "2025-09-18T13:28:58.000Z"
},
{
"user_id": "01995d05-6360-74e9-8aa2-63377289227a",
"name": "Adam Admin",
"email": "admin@example.com",
"role": "admin",
"joined_at": "2026-07-15T13:26:58.000Z"
}
]
}Listar las invitaciones
/workspace/invitationsGratisLas invitaciones pendientes del espacio.
- Solo el propietario o un administrador (el rol del creador de la clave): si no, 403 FORBIDDEN.
Herramienta MCP list_invitations
curl https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Invitar a un miembro
/workspace/invitationsGratisInvita a alguien al espacio por correo: recibe el correo de invitación, válido 7 días.
- Solo el propietario o un administrador (el rol del creador de la clave): si no, 403 FORBIDDEN.
- 409 CONFLICT cuando el correo ya es de un miembro o ya está invitado.
Herramienta MCP invite_member
| Argumento | Tipo | Descripción |
|---|---|---|
emailobligatorio | string | |
roleobligatorio | string | admin o member (por defecto).admin | member |
curl -X POST https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"email": "name@example.com", "role": "admin"}'Responde 201 con { "data": … }.
Cancelar una invitación
/workspace/invitations/{invitationId}GratisCancela una invitación: su enlace deja de funcionar.
- Solo el propietario o un administrador (el rol del creador de la clave): si no, 403 FORBIDDEN.
Herramienta MCP cancel_invitation
| Argumento | Tipo | Descripción |
|---|---|---|
invitationIden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Modificar un miembro
/workspace/members/{userId}GratisCambia el rol de un miembro (admin o member).
- Solo el propietario o un administrador (el rol del creador de la clave): si no, 403 FORBIDDEN.
- userId tal como lo muestra list_members. El rol del propietario no se puede cambiar.
Herramienta MCP update_member
| Argumento | Tipo | Descripción |
|---|---|---|
userIden la ruta | string | Su id. |
roleobligatorio | string | admin | member |
curl -X PATCH https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"role": "admin"}'Responde 200 con { "data": … }.
Quitar a un miembro
/workspace/members/{userId}GratisQuita a un miembro del espacio.
- Propietario o administrador, salvo para quitarte a ti mismo (el creador de la clave sale del espacio). Al propietario no se le puede quitar.
Herramienta MCP remove_member
| Argumento | Tipo | Descripción |
|---|---|---|
userIden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
¿No encuentras la respuesta? Escríbenos.

