Workspaces
| Tool | Endpoint REST | Anotaciones |
|---|---|---|
list_workspaces | GET /v1/workspaces | lectura, idempotente |
Las demás tools aceptan un argumento opcional workspace. Eso no sirve de nada si el modelo no conoce los IDs. Esta tool cierra el círculo: llámala primero, luego pasa el id que quieras usar.
Importa sobre todo con OAuth. En el consentimiento elegiste workspaces; el cliente nunca recibió esos IDs de otra forma.
list_workspaces
Sin argumentos.
Devuelve los workspaces de esta credencial, con nombre, rol y los módulos que tu rol puede tocar. También dice si hace falta pasar workspace en las demás tools.
{
"name": "list_workspaces",
"arguments": {}
}Qué leer de la respuesta
| Campo | Significado |
|---|---|
workspaces[].id | El valor que va en el argumento workspace de las demás tools. |
workspaces[].name | Nombre visible (el de la empresa en Platica). |
workspaces[].role | Rol del usuario en ese workspace (owner, admin, operator, …). |
workspaces[].modules | "all" o la lista de módulos con acceso (conversations, contacts, agents, integrations, …). |
active | Si hay un solo workspace, su id. Si hay varios, null. |
requires_workspace_argument | true cuando hay más de un workspace: las tools de escritura van a pedirlo. |
credential.type | "oauth" o "apiKey". |
credential.scopes | Presente en OAuth: platica:read, platica:write, offline_access. |
Si requires_workspace_argument es true, no adivines el ID: usa el de list_workspaces. Omitirlo en una escritura produce 400 Must specify a valid workspace....
Con una API Key de un solo workspace esta tool también funciona: active sale lleno y no necesitas pasar workspace en el resto.
Documentación REST: Workspaces .