Deployments

Upload deployment archive

Consume a one-time proxied upload credential with a ZIP archive.

POST/api/v1/deploy/uploads/{token}

Authentication: the opaque token in the URL is the one-time credential. Do not add an account bearer token.

Parameters

tokenstringrequired

PathThe opaque, short-lived, one-time upload credential.

archiveZIP filerequired

BodyThe project ZIP in the archive multipart part.

Responses

202

The upload was consumed and its aggregate deployment operation started.

400

The request is invalid or contains an unsupported value.

413

The ZIP exceeds the active upload transport limit.

cURL

curl --fail-with-body --request POST \
  --url "https://api.sitedropper.com/api/v1/deploy/uploads/${UPLOAD_TOKEN}" \
  --form '[email protected]'

Response · 202

{
  "operation": {
    "id": "c14c6816-b498-429b-8aca-dd0a51b615a8",
    "kind": "deployment",
    "status": "queued",
    "stage": "queued",
    "progress": 0,
    "project": {
      "id": "8d7748aa-3e9d-44d5-85f9-928f20a19c62",
      "name": "Studio preview",
      "slug": "preview",
      "description": "Preview site for the studio team",
      "status": "draft",
      "visibility": "draft",
      "url_subdomain": "preview-a13f9c",
      "url": "https://preview-a13f9c.apps.sitedropper.com",
      "created_at": "2026-08-20T22:30:00Z",
      "updated_at": "2026-08-20T22:30:00Z"
    },
    "url": "https://preview-a13f9c.apps.sitedropper.com",
    "created_at": "2026-08-20T22:31:00Z",
    "updated_at": "2026-08-20T22:31:00Z"
  }
}