Skip to main content
Um workspace compartilha aplicações com outros usuários da Square Cloud, cada um com um cargo. client.workspaces gerencia os workspaces, client.workspaces.members seus membros e client.workspaces.apps as aplicações compartilhadas. Criar workspaces requer um plano Standard, Pro ou Enterprise. Os exemplos usam o client de Criando o cliente. workspace_id é o id de um workspace (workspaces.list() lista todos), app_id o id de uma das suas aplicações e member_id o id de um membro.

Workspaces

O dono não pode sair (400 CANNOT_LEAVE_OWNER): exclua o workspace em vez disso.

Membros

Adicionar um membro requer um código de convite que o membro gera com members.invite_code(). O código é válido por 5 minutos.
Cargos (group): view, manager, maintain e admin. Chamar um método que seu cargo não permite resulta em 403 PERMISSION_DENIED.

Aplicações compartilhadas

Um workspace pode conter até 100 aplicações (400 APPLICATIONS_LIMIT_REACHED).

Atuando sobre uma aplicação compartilhada

Para atuar sobre uma aplicação compartilhada com você, passe o id composto <appId>-<workspaceId> para qualquer método de client.apps. workspaces.get() e workspaces.list() retornam ids brutos, então monte-o você mesmo:

Erros

As rotas de workspace enviam os ids no corpo da requisição, então um id vazio resulta em 400 INVALID_ID vindo do servidor (não é um erro local). A exceção é workspaces.get(), cujo id fica no caminho da URL: nele, um id vazio falha localmente.

Próximos passos

IA

Chat completions pelo AI Gateway.

Referência da API de workspaces

Os endpoints REST por trás destes métodos.

Workspaces pela CLI

As mesmas ações pelo terminal.