exchange proxy access

Consume a one-time sign-in code with its verifier and current policy. Current organisation membership and roles are checked again.

POST /api/v1/access/exchange

exchange proxy access

Python

import requests

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

payload = {
    "policy": {
        "hostname": "<string>",
        "organisation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "roles": ["<string>"]
    },
    "code": "<string>",
    "verifier": "<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)

200

{
  "session": "<string>",
  "expires_in": 123
}

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

code · string · required

verifier · string · required

Response

200

application/json

Sign-in continuation

session · string · required

expires_in · integer · required