Skip to main content
Un workspace comparte aplicaciones con otros usuarios de Square Cloud, cada uno con un rol. client.workspaces gestiona los workspaces, client.workspaces.members sus miembros y client.workspaces.apps las aplicaciones compartidas. Crear workspaces requiere un plan Standard, Pro o Enterprise. Los ejemplos usan el client de Crear el cliente. workspace_id es el id de un workspace (workspaces.list() los lista), app_id el id de una de tus aplicaciones y member_id 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.invite_code(). 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 client.apps. workspaces.get() y workspaces.list() devuelven ids sin procesar, así que constrúyelo tú mismo:

Errores

Las rutas de workspace envían los ids en el cuerpo de la petición, así que un id vacío da 400 INVALID_ID desde el servidor (no es un error local). La excepción es workspaces.get(), cuyo id va en la ruta de la URL: ahí, un id vacío falla localmente.

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.