---
title: "Cancel a collab scene"
method: POST
path: "/api/v1/collab-scenes/{sceneId}/cancel"
tags: ["Collab Scenes"]
---

# Cancel a collab scene

`POST /api/v1/collab-scenes/{sceneId}/cancel`

## Request

- Base URL: `https://easy2257.com`
- URL: `https://easy2257.com/api/v1/collab-scenes/{sceneId}/cancel`
- Auth: HTTP bearer

Cancels a scene that is still in `pending_signatures`, and notifies you with `collab_scene.cancelled`. No refund is issued: the fees paid for record creation and for verification sessions that were already started. Only the scene's creating partner can cancel it.

## Path parameters

- `sceneId` string, required

## Response `200`

Cancelled.

- object
  - `sceneId` string, required
  - `status` 'cancelled', required
  - `refunded` false, required

## Other responses

- `400`: Invalid request: a required field is missing or malformed.
- `401`: No `Authorization: Bearer` header, or a key that is unknown, revoked, or expired. The body carries only `error`, never a `code`.
- `403`: Rejected before the handler: a test-mode key (`TEST_MODE_UNAVAILABLE`) or a partner account that is not ACTIVE. Never used for cross-partner access, which returns 404.
- `404`: No such scene, or it belongs to another partner.
- `422`: The scene is not in `pending_signatures`. `code` is `invalid_status`.
- `429`: Rate limit exceeded: 300 requests per 60 seconds per API key, shared across all `/api/v1` endpoints (requests without a `Bearer` key fall back to 60 per 60 seconds per client IP, and a per-address flood ceiling of 1200 per 60 seconds also applies). Honor `Retry-After`.
- `500`: Server error. Retry with exponential backoff.

---

[API](https://skmtc.dev/easy2257/apis/easy2257-partner-api.md) · [All operations](https://skmtc.dev/easy2257/apis/easy2257-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/easy2257/apis/easy2257-partner-api/revisions/f880026c1f04?raw)