Atomically replace an immutable Access Binding

POST
/v1/access/bindings/replace

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/replace" \  -H "Content-Type: application/json" \  -d '{    "binding_id": "string",    "expected_version": 1,    "replacement": {      "subject": {        "type": "user",        "id": "string"      }    },    "idempotency_key": "string"  }'
{  "previous": {    "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"    }  },  "current": {    "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"    }  }}