Operations

Retrieve operation

Retrieve aggregate deployment progress and its final URL or error.

GET/api/v1/operations/{operationID}

Authentication: REST bearer token required.

Parameters

operationIDUUIDrequired

PathThe aggregate operation UUID.

Responses

200

The current aggregate operation.

400

The request is invalid or contains an unsupported value.

401

The bearer token is missing, invalid, or expired.

404

The requested resource does not exist for this account.

cURL

curl --fail-with-body --request GET \
  --url "https://api.sitedropper.com/api/v1/operations/${OPERATION_ID}" \
  --header "Authorization: Bearer $SITEDROPPER_TOKEN"

Response · 200

{
  "operation": {
    "id": "c14c6816-b498-429b-8aca-dd0a51b615a8",
    "kind": "deployment",
    "status": "running",
    "stage": "building",
    "progress": 62,
    "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"
  }
}