Skip to main content
POST
Start Application
string
required
The application ID to start. If the application belongs to a workspace, pass its ID in the workspace_id query parameter.
string
If the application belongs to a workspace, the workspace’s ID. Required for workspace members acting on an application they don’t own.

Response

object
The response containing the operation status.

Error Responses

string
The error code indicating the reason for the failure. Possible values:
  • APP_NOT_FOUND: The specified application does not exist.
  • ACCESS_DENIED: The user does not have permission to act on the application.
  • APPLICATION_SHIELD_COOLDOWN: Vertra Shield temporarily paused the application; retry after the cooldown (403).
  • OPERATION_IN_PROGRESS: Another lifecycle operation on the same application is already running (409). The container was not touched — wait a few seconds and retry. See Common Error Codes.
This route shares a budget of 10 requests per minute per application with restart and stop. See Rate Limiting.