Skip to main content
POST
Revoke a connection

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Required for AgentLeaseBearer principals. Replays the original identical agent revocation and rejects reuse for another connection.

Path Parameters

connectionId
string
required

Body

application/json
expectedVersion
integer<int64>

Required and positive for API-key and user principals. Agent principals must omit it.

Required range: x >= 1

Response

Revoked safe connection tombstone.

connection
object
required

Safe connection metadata. Credential material is never returned.