Skip to main content
Um workspace compartilha aplicações com outros usuários da Square Cloud, cada um com um cargo. api.workspaces gerencia os workspaces, api.workspaces.members seus membros e api.workspaces.apps as aplicações compartilhadas. Criar workspaces requer um plano Standard, Pro ou Enterprise. Os exemplos usam o cliente api de Criando o cliente. workspaceId é o id de um workspace (workspaces.list() lista todos), appId o id de uma das suas aplicações e memberId 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.inviteCode(). 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 api.apps. workspaces.get() e workspaces.list() retornam ids brutos, então monte-o você mesmo:

Erros

Exceto workspaces.get(), as rotas de workspace enviam os ids no corpo da requisição, então um id vazio nelas resulta em 400 INVALID_ID vindo do servidor, não em um erro local.

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.