Disaster Recovery

Request a replacement for a resource

Asks the creator, on the connector, to pick the chat that replaces the resource's: the same conversation a standby request starts, ending in a swap instead of a spare. For a degraded resource the swap will spend the channel recovery allowance or join the recovery already absorbing swaps; for a healthy one it is on demand and free. Answers 202 once the request is sent.

post/v1/projects/{project}/resources/{resource}/replacement/request

Request

Base URL: https://api.subscriby.net
URL: https://api.subscriby.net/v1/projects/{project}/resources/{resource}/replacement/request
Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

resourcestring uuid required

The resource, resolved within the project by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Response

202 with resource_id and status: request_sent.

Example response

{
  "data": {
    "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "status": "request_sent"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.