> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Compartilhar aplicação com um workspace

> Compartilhe uma aplicação sua com um workspace seu via POST /v2/workspaces/applications, e os membros ganham acesso por função, sem transferência.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `workspaces:manage`.

Compartilha uma aplicação pertencente ao usuário autenticado em um workspace que ele também possui, dando aos membros do workspace acesso a ela de acordo com a função de cada um, em vez de transferir a propriedade. Um workspace comporta até 100 aplicações compartilhadas, e a mesma aplicação não pode ser compartilhada duas vezes no mesmo workspace.

Esta é uma ação exclusiva do dono do workspace: quem faz a chamada precisa possuir tanto o workspace quanto a aplicação. Use [Obter informações da aplicação](/pt-br/api-reference/endpoint/apps/info) antes para confirmar o ID da aplicação, e [Remover aplicação](/pt-br/api-reference/endpoint/workspace/apps/remove) para desfazer o compartilhamento depois. Limitado a 10 adições a cada 30 segundos por usuário.

## Parâmetros

<ParamField body="workspaceId" type="string" placeholder="ID do Workspace" required>
  O ID do workspace.
</ParamField>

<ParamField body="appId" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
    "status": "success"
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `INVALID_ID` | 400 | `workspaceId` está ausente. |
| `APP_NOT_FOUND` | 400 | `appId` está ausente no corpo da requisição. |
| `APP_NOT_FOUND` | 404 | Nenhuma aplicação com esse ID existe para o solicitante. |
| `WORKSPACE_NOT_FOUND` | 404 | O workspace não existe ou não pertence ao solicitante. |
| `APPLICATIONS_LIMIT_REACHED` | 400 | O workspace já possui 100 aplicações compartilhadas. |
| `APP_ALREADY_IN_WORKSPACE` | 400 | A aplicação já está compartilhada nesse workspace. |

## Relacionados

* CLI: [`squarecloud workspace app add`](/pt-br/cli-reference/workspaces#squarecloud-workspace-app-add)
* SDKs: [`api.workspaces.apps.add()`](/pt-br/sdks/js/workspaces) (JavaScript), [`client.workspaces.apps.add()`](/pt-br/sdks/py/workspaces) (Python), [`c.Workspaces.Apps.Add()`](/pt-br/sdks/go/workspaces) (Go)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.