Skip to main content
POST
/
v2
/
apps
/
{app_id}
/
snapshots
Create Snapshot
curl --request POST \
  --url https://api.squarecloud.app/v2/apps/{app_id}/snapshots \
  --header 'Authorization: <authorization>'
{
    "status": "success",
    "response": {
        "url": "https://snapshots.squarecloud.app/applications/23457145698959364/a23d130fcc9ddaf2d288ae9599a4292c32.zip?AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D",
        "key": "AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D"
    }
}

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.

Each account can perform up to (RAM / 256) * 2 snapshots every 24 hours.
​
Authorization
string
required
The API key for your account. You can find this in your account settings.
​
app_id
string
required
The ID of the application. You can find this in the URL of your application’s dashboard.

​
Response

​
status
string
Indicates whether the call was successful.. success if successful, error if not.
​
response
object
The contents of the response.

​
Errors

A snapshot request can be rejected with 429 Too Many Requests. Use the code field to tell the two cases apart:
​
KEEP_CALM
429
Short-term cooldown — you hit the per-user (1 request / 5s) or per-application (1 request / 60s) limit. Back off and retry shortly.
​
DAILY_SNAPSHOTS_LIMIT_REACHED
429
Daily quota reached — the account used up its plan’s daily snapshot allowance ((RAM / 256) × 2 per 24h). The quota frees up as the rolling 24-hour window advances; for a higher daily allowance, upgrade the plan.
{
    "status": "success",
    "response": {
        "url": "https://snapshots.squarecloud.app/applications/23457145698959364/a23d130fcc9ddaf2d288ae9599a4292c32.zip?AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D",
        "key": "AWSAccessKeyId=i06Xdad2dRD74Pm8Xly&Expires=1753081182&Signature=riWPedawcsouRAPGU5n3kGHnWoOuw%3D"
    }
}