Skip to main content
Un workspace comparte aplicaciones con otros usuarios de Square Cloud, cada uno con un rol. api.workspaces gestiona los workspaces, api.workspaces.members sus miembros y api.workspaces.apps las aplicaciones compartidas. Crear workspaces requiere un plan Standard, Pro o Enterprise. Los ejemplos usan el cliente api de Crear el cliente. workspaceId es el id de un workspace (workspaces.list() los lista), appId el id de una de tus aplicaciones y memberId el id de un miembro.

Workspaces

El propietario no puede abandonar el workspace (400 CANNOT_LEAVE_OWNER): en su lugar, elimina el workspace.

Miembros

Añadir un miembro requiere un código de invitación que el miembro genera con members.inviteCode(). El código es válido durante 5 minutos.
Roles (group): view, manager, maintain y admin. Llamar a un método que tu rol no permite da 403 PERMISSION_DENIED.

Aplicaciones compartidas

Un workspace puede contener hasta 100 aplicaciones (400 APPLICATIONS_LIMIT_REACHED).

Actuar sobre una aplicación compartida

Para actuar sobre una aplicación compartida contigo, pasa el id compuesto <appId>-<workspaceId> a cualquier método de api.apps. workspaces.get() y workspaces.list() devuelven ids sin procesar, así que constrúyelo tú mismo:

Errores

Salvo workspaces.get(), las rutas de workspace envían los ids en el cuerpo de la petición, así que un id vacío ahí da 400 INVALID_ID desde el servidor, no un error local.

Próximos pasos

IA

Chat completions a través del AI Gateway.

Referencia de la API de workspaces

Los endpoints REST detrás de estos métodos.

Workspaces desde la CLI

Las mismas acciones desde la terminal.