Saltar al contenido principal

Workspace

La API de Workspace expone acceso de lectura a los metadatos de tu workspace, sus miembros y sus equipos. Es el directorio al que recurres cuando necesitas resolver el id de un miembro (por ejemplo, para dirigir un mensaje directo) o para enumerar equipos.

Inicio rápido​

# Read workspace metadata
curl -X GET https://api.copera.ai/public/v1/workspace/info \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

# List members (search by name or email with q)
curl -X GET "https://api.copera.ai/public/v1/workspace/members?q=alice" \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

# List teams
curl -X GET https://api.copera.ai/public/v1/workspace/teams \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

Disponible en​

Public APICLIMCPCopera AI
✅ Completo✅ Completo✅ Completo—

El CLI y el servidor MCP alojado exponen la información, los miembros y los equipos del workspace. El directorio del workspace no está expuesto al asistente Copera AI integrado en la app.

Información del workspace​

Haz un GET al endpoint info para obtener los metadatos principales del workspace: _id, name, slug, picture y description opcionales, el número de seats y marcas de tiempo.

Miembros​

Haz un GET al endpoint members para listar a las personas del workspace. Cada miembro incluye:

  • _id, name, email, picture y title opcionales.
  • type — user, guest, integration, ai o external.
  • status — presencia: online, offline, idle o invisible.
  • active — si la cuenta está activa.

Parámetros de consulta soportados:

  • q — búsqueda sin distinción de mayúsculas y minúsculas en el nombre y el email.
  • limit — 1–500 (por defecto 100).
  • offset — desplazamiento de página (por defecto 0).
consejo

Así es como resuelves el userId de un miembro antes de enviar un mensaje directo — busca por nombre o email con q, y luego usa el _id devuelto.

Equipos​

Haz un GET al endpoint teams para listar los equipos del workspace. Cada equipo incluye su _id, name, picture opcional, una bandera main (el equipo predeterminado del workspace), los participants (ids de miembros), createdBy y marcas de tiempo. Soporta los mismos parámetros q, limit (1–200, por defecto 100) y offset.

Autenticación y alcance​

Los endpoints de Workspace requieren un Personal Access Token (cp_pat_). Los usuarios externos no pueden acceder a este endpoint. Consulta Autenticación.

Referencia​