latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-15140179507.6 KB

d3adfe49fbbf

Server connections

Cancel a connection request

Stops a request and invalidates its handoff link. Cancelling an already-terminal request is a no-op.

post/server-connections/{requestId}/cancel

Path parameters

requestIdstring required

The scr_… connection request id.

Request body

object required

Response

Request cancelled.

connectionRequestIdstring required

Public scr_… identifier. Safe to print; it is never sufficient to act on a request.

status'discovering' | 'awaiting_project' | 'awaiting_authorization' | 'authorizing' | 'validating' | 'ready' | 'failed' | 'expired' | 'cancelled' required
handoffUrlstring

Where the user finishes in a browser, for both awaiting_project and awaiting_authorization. Returned ONLY by the create call — the raw token behind it is minted once and never stored. Treat it as a private, single-person capability: never post it to a shared channel.

expiresAtstring date-time required
projectIdstring
serverIdstring