POST /v1/auth/challenge/{challengeId}/consume

Error	HTTP	Meaning	Fix
`invalid_token`	401	Token missing, wrong, or expired	Use the fresh verificationToken from poll Diagnose →
`already_consumed`	409	Token already used	Start a new challenge; do not retry consume Diagnose →

SDK equivalent

TypeScript — @keyra/typescript-sdk: consumeChallenge(challengeId, verificationToken)
Java — ie.keyra:keyra-java-sdk: consumeChallenge(...)

Examples

Bash

curl -X POST "https://auth.keyra.ie/v1/auth/challenge/chg_xxxxxxxx/consume" \
  -H "Authorization: Bearer CLIENT_ID:CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"verificationToken":"vrf_xxxxxxxx"}'

Response

response.jsonJSON

{
  "challengeId": "string",
  "consumed": true,
  "identityId": "string"
}

Bash

curl -X POST "https://auth.keyra.ie/v1/auth/challenge/chg_xxxxxxxx/consume" \
  -H "Authorization: Bearer CLIENT_ID:CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"verificationToken":"vrf_xxxxxxxx"}'

Response

response.jsonJSON

{
  "challengeId": "string",
  "consumed": true,
  "identityId": "string"
}