Revoke an Access Binding using compare-and-swap

POST
/v1/access/bindings/revoke

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/access/bindings/revoke" \  -H "Content-Type: application/json" \  -d '{    "binding_id": "string",    "expected_version": 1,    "idempotency_key": "string"  }'
{  "binding_id": "string",  "subject": {    "type": "user",    "id": "string",    "description": "string"  },  "resource": {    "type": "server",    "deployment_id": "string"  },  "role": "handoff.viewer",  "granted_by": {    "type": "user",    "id": "string",    "description": "string"  },  "reason": "string",  "created_at": "2019-08-24T14:15:22Z",  "expires_at": "2019-08-24T14:15:22Z",  "state": "active",  "version": 1,  "policy_revision": "string",  "idempotency_key": "string",  "revoked_at": "2019-08-24T14:15:22Z",  "revoked_by": {    "type": "user",    "id": "string",    "description": "string"  }}