Skip to navigation

Get offline permit

Exchanges the offline challenge proof for a signed, installation-bound permit. Its deadline cannot exceed the app window or identity entitlement. Offline access cannot immediately learn about later bans.

Authentication

AuthorizationBearer
Opaque v3 session token returned by login, bound to its identity and installation.

Headers

X-AuthlyX-NoncestringRequiredformat: "^[a-f0-9]{32,128}$"
Fresh random hexadecimal nonce. Do not reuse.
X-AuthlyX-TimestampstringRequired

Server-aligned Unix time in milliseconds.

X-AuthlyX-SignaturestringRequired

Base64 Ed25519 installation signature over the exact request-proof payload.

Request

This endpoint expects an object.
challengeIdstringRequired

ID from an unexpired single-use challenge for this operation.

signaturestringRequired
Base64 Ed25519 signature over the challenge proof payload.

Response

Successful
successboolean
codestring
messagestring
dataobject or null
requestIdstringformat: "uuid"
verificationobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
413
Content Too Large Error
415
Unsupported Media Type Error
429
Too Many Requests Error
503
Service Unavailable Error