Deployments

Finalize direct upload

Verify a completed direct GCS upload and start deployment.

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

Finalization verifies object ownership, expiry, exact size, optional checksum, one-time use, and immutable generation before analysis.

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.

Responses

202

The direct object was verified 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}/finalize"

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