Skip to main content
POST
Verify an authorization

Path Parameters

authorizationId
string
required

Authorization ID returned by POST /v1/authorizations. A value that is not a well-formed ID returns 404.

Pattern: ^auth_[0-9A-HJKMNP-TV-Z]{26}$

Response

The authorization is verified.

Current state of an authorization. Reading it moves a lapsed PENDING or VERIFIED authorization to EXPIRED.

authorizationId
string
required

auth_ plus 26 Crockford base32 characters.

status
enum<string>
required

PENDING: challenge issued, not yet verified. VERIFIED: Selo found the token and may test the target until expiresAt. EXPIRED: the challenge or the authorization lapsed. REVOKED: the authorization was withdrawn.

Available options:
PENDING,
VERIFIED,
EXPIRED,
REVOKED
origin
string
required
routePath
string
required
method
enum<string>
required

HTTP method Selo uses to call the target.

Available options:
GET,
POST
type
enum<string>
required

well_known_file: verified through /.well-known/selo-verification.txt on the target origin. manual_owner_consent: an explicit consent recorded by the Selo operator.

Available options:
well_known_file,
manual_owner_consent
verifiedAt
string<date-time> | null
required

When Selo verified the token, or null while pending.

expiresAt
string<date-time>
required

While PENDING, when the challenge closes (one hour after creation). Once VERIFIED, when the authorization lapses (24 hours after verification).