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

# Restart Application

> Restart your application.

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

Restarts a running application, equivalent to a stop followed by a start performed as a single atomic action on the cluster. This is the endpoint to call after [Commit Application](/en/api-reference/endpoint/apps/commit) so newly pushed files take effect, since committing on its own does not restart the application.

On workspace-shared applications, the caller needs the Manager, Maintainer, or Administrator role. The request is rate limited to 1 restart per 3 seconds per application, and to 20 lifecycle actions per 15 seconds per user across all applications, with a 60-second block once that cap is hit. To check whether the restart finished, poll [Get Application Status](/en/api-reference/endpoint/apps/status) or watch [Real-time Logs](/en/api-reference/endpoint/apps/realtime).

### Parameters

<ParamField path="app_id" 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 successful, `error` if not.
</ResponseField>

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

### Common errors

| Code            | HTTP | Meaning                                                                             |
| --------------- | ---- | ----------------------------------------------------------------------------------- |
| `ACTION_FAILED` | 409  | The cluster rejected the action, for example the application is already mid-deploy. |