Developers
V1MeClinicalAccess requestsRequestidRevoke

Revoke clinical access

POST
/v1/me/clinical/access-requests/{requestId}/revoke

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

requestId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Default{}

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/me/clinical/access-requests/497f6eca-6276-4993-bfeb-53cbbbba6f08/revoke" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "status": "pending",  "practitioner": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "licenseAuthority": "string",    "licenseNumber": "string",    "specialistRegistration": "string",    "specialty": "string",    "organization": "string",    "verifiedAt": "2019-08-24T14:15:22Z",    "verificationValidUntil": "2019-08-24T14:15:22Z"  },  "requestedAt": "2019-08-24T14:15:22Z",  "pendingExpiresAt": "2019-08-24T14:15:22Z",  "approvedAt": "2019-08-24T14:15:22Z",  "expiresAt": "2019-08-24T14:15:22Z",  "deniedAt": "2019-08-24T14:15:22Z",  "revokedAt": "2019-08-24T14:15:22Z",  "purpose": "consultation_recordkeeping",  "scope": "read_and_add",  "noticeVersion": "2026-09-09"}

Deny a pending clinical request POST

Previous Page

Your currently verified practitioner identity, or null GET

Only the signed-in user's active, manually verified profile with valid credentials is returned. Registration does not establish verification. This response enables practitioner tools; each subsequent operation independently checks verification and patient approval.