Workspaces

Un workspace es el tenant al que pertenece un inbox. Seis tools; las de escritura están restringidas a tokens de sistema, porque un workspace lo aprovisiona el sistema de origen, no un usuario final.

Ver el modelo Workspace para la forma del objeto devuelto.

---

workspaces_list

Lectura · scope inbox/workspaces · permiso workspaces.list · GET /workspaces

Lista los workspaces de la organización del token. Paginado por cursor; devuelve { data, meta: { next_cursor } }.

Parámetro	Tipo	Descripción
cursor	string	Cursor opaco de una página anterior.
limit	integer	Tamaño de página, por defecto 25, máximo 100.
sort	string	Claves de ordenación, prefijo - para descendente.
source	string	Filtra por sistema de origen, p.ej. kobana_app.
slug	string	Filtra por slug.
external_id	string	Filtra por el id en el sistema de origen.
created_at_gte	string	created_at desde este timestamp ISO 8601.
created_at_lte	string	created_at hasta este timestamp ISO 8601.

workspaces_get

Lectura · scope inbox/workspaces · permiso workspaces.show · GET /workspaces/{id}

Obtiene un workspace por id interno o external_id.

Parámetro	Tipo	Descripción
id obligatorio	string	Id interno o external_id.

workspaces_create

Escritura · scope inbox/workspaces + write · permiso workspaces.create · POST /workspaces

Crea un workspace. Requiere un token src=system.

Parámetro	Tipo	Descripción
label obligatorio	string	Nombre visible, 1–120 caracteres.
external_id	string	Id del registro en el sistema de origen.
source	string	Sistema de origen, p.ej. kobana_app.
slug	string	Minúsculas, con guiones. Pasa a ser un segmento de la dirección de cada inbox.
monthly_cost_limit	number | null	Techo mensual de coste de LLM.
monthly_emails_limit	integer | null	Techo mensual de correos procesados.
custom_metadata	object	JSON libre, de quien llama.
idempotency_key	string	Protección contra repeticiones, 8–255 caracteres.

workspaces_upsert

Escritura · scope inbox/workspaces + write · permiso workspaces.create · PUT /workspaces

Crea o actualiza un workspace, emparejado por id y luego external_id. Responde 200 al actualizar y 201 al crear. Requiere un token src=system.

Parámetro	Tipo	Descripción
id	string (uuid)	Empareja primero por id interno.
label	string	Nombre visible, 1–120 caracteres.
external_id	string	Clave de emparejamiento en el sistema de origen.
source	string	Sistema de origen.
slug	string	Minúsculas, con guiones.
monthly_cost_limit	number | null	Techo mensual de coste.
monthly_emails_limit	integer | null	Techo mensual de correos.
custom_metadata	object	JSON libre.
idempotency_key	string	Protección contra repeticiones.

workspaces_update

Escritura · scope inbox/workspaces + write · permiso workspaces.update · PATCH /workspaces/{id}

Actualiza un workspace en su sitio. Cambiar los límites requiere un token src=system.

Parámetro	Tipo	Descripción
id obligatorio	string	Id interno o external_id.
label	string	Nombre visible, 1–120 caracteres.
external_id	string	Id en el sistema de origen.
source	string	Sistema de origen.
slug	string	Minúsculas, con guiones.
monthly_cost_limit	number | null	Techo mensual de coste.
monthly_emails_limit	integer | null	Techo mensual de correos.
custom_metadata	object	JSON libre.

workspaces_delete

Destructiva · scope inbox/workspaces + write · permiso workspaces.delete · DELETE /workspaces/{id}

Elimina (soft-delete) un workspace. Requiere un token src=system.

Parámetro	Tipo	Descripción
id obligatorio	string	Id interno o external_id.