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ónLlamada
Listar los miembrosGET /workspace/membersGratis
Listar las invitacionesGET /workspace/invitationsGratis
Invitar a un miembroPOST /workspace/invitationsGratis
Cancelar una invitaciónDELETE /workspace/invitations/{invitationId}Gratis
Modificar un miembroPATCH /workspace/members/{userId}Gratis
Quitar a un miembroDELETE /workspace/members/{userId}Gratis

Listar los miembros

GET/workspace/membersGratis

Los miembros del espacio y su rol.

Herramienta MCP list_members

Petición
curl https://app.semchat.io/api/v1/workspace/members \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "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

GET/workspace/invitationsGratis

Las 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

Petición
curl https://app.semchat.io/api/v1/workspace/invitations \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Invitar a un miembro

POST/workspace/invitationsGratis

Invita 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

ArgumentoTipoDescripción
emailobligatoriostring
roleobligatoriostringadmin o member (por defecto).admin | member
Petición
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

DELETE/workspace/invitations/{invitationId}Gratis

Cancela 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

ArgumentoTipoDescripción
invitationIden la rutastringSu id.
Petición
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Modificar un miembro

PATCH/workspace/members/{userId}Gratis

Cambia 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

ArgumentoTipoDescripción
userIden la rutastringSu id.
roleobligatoriostringadmin | member
Petición
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

DELETE/workspace/members/{userId}Gratis

Quita 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

ArgumentoTipoDescripción
userIden la rutastringSu id.
Petición
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.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos