check proxy access

Validate the host-bound opaque session and check live organisation membership, SSO verification and exact organisation-wide role grants.

POST /api/v1/access/check

check proxy access

Python

import requests

url = "https://platform.ankra.app/api/v1/access/check"

payload = {
    "policy": {
        "hostname": "<string>",
        "organisation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "roles": ["<string>"]
    },
    "session": "<string>"
}
headers = {
    "X-Ankra-Access-Token": "<x-ankra-access-token>",
    "X-Ankra-Internal-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Authorizations

X-Ankra-Internal-Token · string · header · required

Platform service-to-service credential held by Ankra-operated relays, accepting current and next values during rotation. Not issued to customers.

Headers

X-Ankra-Access-Token · string · required

Body

application/json

policy · object · required

Show child attributes

session · string · required

Response

204

Access allowed