> ## 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.

# Share an application with a workspace

> Share an application you own with a workspace you own via POST /v2/workspaces/applications, so members get access by role without a transfer.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

Requires an API key with the `workspaces:manage` [scope](/en/api-reference/authentication#scopes).

Shares an application owned by the authenticated user into a workspace they also own, giving the workspace's members access to it according to their role instead of transferring ownership. A workspace holds up to 100 shared applications, and the same application cannot be shared into the same workspace twice.

This is a workspace-owner-only action: the caller must own both the workspace and the application. Use [Get Application Info](/en/api-reference/endpoint/apps/info) beforehand to confirm the application ID, and [Remove Application](/en/api-reference/endpoint/workspace/apps/remove) to undo the share later. Rate limited to 10 additions per 30 seconds per user.

## Parameters

<ParamField body="workspaceId" type="string" placeholder="Workspace Id" required>
  The ID of the workspace.
</ParamField>

<ParamField body="appId" type="string" placeholder="Application ID" required>
  The ID of the application. You can find this in the URL of your application's dashboard.
</ParamField>

## Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful: `success` if it was, `error` if not.
</ResponseField>

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

## Common errors

| Code | HTTP | Meaning |
| - | - | - |
| `INVALID_ID` | 400 | `workspaceId` is missing. |
| `APP_NOT_FOUND` | 400 | `appId` is missing from the request body. |
| `APP_NOT_FOUND` | 404 | No application with that ID exists for the caller. |
| `WORKSPACE_NOT_FOUND` | 404 | The workspace does not exist or is not owned by the caller. |
| `APPLICATIONS_LIMIT_REACHED` | 400 | The workspace already has 100 shared applications. |
| `APP_ALREADY_IN_WORKSPACE` | 400 | The application is already shared into this workspace. |

## Related

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


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