Operations

Cancel operation

Request cancellation of a queued or running aggregate operation.

POST/api/v1/operations/{operationID}/cancel

Authentication: REST bearer token required.

Parameters

operationIDUUIDrequired

PathThe aggregate operation UUID.

Responses

202

Cancellation was accepted and the operation reflects its latest state.

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.

409

The request conflicts with the current resource state.

cURL

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

Response · 202

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