Atomically consume a hashed Portal auth challenge

post/portal-auth/challenges/consume

Request

  • Base URL: https://api.gravityads.dev (the document declares no server; this is the origin it was published from)
  • URL: https://api.gravityads.dev/portal-auth/challenges/consume
  • Auth: HTTP bearer

Request body

challenge_hashstring required

SHA-256 hash of the token nonce; raw nonce is forbidden.

challenge_type'email_magic_link' | 'github_oauth_state' | 'google_oauth_state' | 'microsoft_oauth_state' | 'password_reset' required
identity_hashstring
expires_atstring date-time required
resolve_email_identityboolean

Consume only: resolve canonical membership after an isolated Portal email attestation. No provider binding or automatic membership updates.

email_attestationstring

Response

Portal auth challenge consumed

status'portal_auth_challenge_registered' | 'portal_auth_challenge_already_exists' | 'portal_auth_challenge_consumed' | 'portal_auth_challenge_unavailable' | 'portal_auth_challenge_unconfigured' | 'portal_auth_challenge_degraded' | 'portal_auth_challenge_failed' required
registeredboolean
consumedboolean
challenge_typestring required
hosted_auth_contextobject
raw_challenge_returnedfalse required
raw_identity_returnedfalse required
raw_secrets_returnedfalse required

Changes

No recorded changes to this operation across all 1 revision of this API.