Saltar al contenido principal

Organización

La organización en cuyo nombre actúa el token de la conexión, en singular. Dos tools: obtener y actualizar. Ninguna recibe id ni workspace: la organización sale solo del token, nunca de un argumento, y su perfil vale para todos los workspaces.


organization_get​

Lectura · scope inbox/workspaces · permiso settings.show · GET /organization

Devuelve la organización del token: id, public_id, external_id, name, slug, document_type, document_number, email, phone, custom_metadata, created_at, updated_at. El mismo JSON que GET /v1/organization. Las configuraciones comerciales de Kobana (cortesía, plan, límites, socio) y los metadatos de sistema nunca se devuelven.

Esta tool no recibe parámetros. Todos los roles de sistema (propietario, admin, lector) tienen settings.show.

organization_update​

Escritura · scope inbox/workspaces + write · permiso settings.update · PATCH /organization

Actualiza el custom_metadata de la organización. Lo mismo que PATCH /v1/organization. Propietario y admin tienen settings.update.

ParámetroTipoDescripción
custom_metadataobject | nullJSON libre, tuyo. null conserva el valor guardado.
custom_metadata_modestringreplace (por defecto) o merge (fusiona en profundidad sobre el valor guardado).

La identidad (external_id, slug, document_type, document_number) no se puede cambiar, ni tampoco name, email y phone: reflejan la cuenta Kobana y se sincronizan desde ella. Si se envían, se ignoran. Las configuraciones comerciales de Kobana no son parámetros de esta tool; el endpoint rechaza con 403 FORBIDDEN un cuerpo que mencione alguna. Cada cambio queda en el registro de auditoría de la organización.

El scope es inbox/workspaces porque el servidor de autorización todavía no tiene el scope inbox/settings: la organización es la dueña de los workspaces.