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

# Add Application

> Add an application into the workspace.

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

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">
  The ID of the workspace.
</ParamField>

<ParamField body="appId" type="string" placeholder="Application ID">
  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 successful, `error` if not.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "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.      |