Workspaces

El resto de la API asume que ya sabes el ID del workspace. Eso vale para una API Key: quien la creó lo conocía. Un cliente MCP conectado con OAuth no: el usuario eligió workspaces en la pantalla de consentimiento y el modelo nunca vio esos IDs.

Este endpoint es ese directorio. La tool MCP list_workspaces es la misma llamada.

GET https://api.platica.mx/v1/workspaces

No está atado a un módulo del workspace: saber a qué equipos perteneces no es algo que un rol oculte, y un cliente OAuth necesita este listado antes de poder nombrar un workspace en cualquier otra ruta.

Acepta las dos credenciales Bearer: un access token OAuth (pl_at_…) o una API Key (pl_key_…). Ver Autenticación .

Respuesta

{
  "active": null,
  "requires_workspace_argument": true,
  "credential": {
    "type": "oauth",
    "scopes": ["platica:read", "platica:write", "offline_access"]
  },
  "count": 2,
  "workspaces": [
    {
      "id": "g6yCA16pkWl5eXo7KszB",
      "name": "Acme Norte",
      "role": "admin",
      "modules": "all"
    },
    {
      "id": "k2pL90vQmN4sHxYwR8cD",
      "name": "Acme Soporte",
      "role": "operator",
      "modules": ["dashboard", "conversations", "agents", "campaigns", "contacts", "chat"]
    }
  ]
}

Campo	Tipo	Descripción
`active`	string \| null	Si la credencial cubre un workspace, su `id`. Si cubre varios, `null`: hay que pasar `?workspace=` en las escrituras.
`requires_workspace_argument`	boolean	`true` cuando `count > 1`. Es el mismo criterio que usan las tools MCP.
`credential.type`	string	`"oauth"` o `"apiKey"`.
`credential.scopes`	string[]	Sólo en OAuth. Los scopes otorgados en el consentimiento.
`count`	number	Workspaces que esta credencial puede alcanzar ahora.
`workspaces[].id`	string	Valor de `?workspace=` (o del argumento `workspace` en MCP).
`workspaces[].name`	string	Nombre de la empresa en Platica.
`workspaces[].role`	string \| null	Rol del usuario en ese workspace.
`workspaces[].modules`	`"all"` \| string[]	Módulos con acceso. En OAuth se leen del rol en vivo; en una API Key es `"all"`.

Nota

Los workspaces de un token OAuth se vuelven a cruzar con la membresía actual en cada request. Si te sacaron de un equipo, deja de aparecer aquí y el token deja de alcanzarlo — no hay que revocar el grant.

Errores

Status	Causa
`401`	Falta el Bearer, o el token/key no es válido.
`404`	La credencial no tiene ningún workspace alcanzable.

Anterior Autenticación Siguiente Introducción