Prove the genuine iOS app for the current guest session
POST/auth/app-attest
Verifies an Apple App Attest attestation (new key) or assertion (registered key) over the session's attestChallenge from GET /auth/info and marks the guest session attested; with App Attest on, only an attested ios_app guest session can start a search. Idempotent: an already attested session gets 204 without verification. A refused proof changes nothing. Applies only to an ios_app guest session while App Attest is on; any other caller with a recognised guest selector gets 403 app_attest_failed. A missing or unrecognised guest selector (including web_guest while the web guest flag is off) returns 401; a missing or non-guest session is a 403 app_attest_failed; a malformed or oversized body 400.
Request
Responses
- 204
- 400
- 401
- 403
- 503
Session is attested.
Bad request
Unauthorized
Proof rejected or not applicable (App Attest off, web guest, account session, no guest session); GeneralError.message is app_attest_failed. The cause is logged, never returned.
Attest store unavailable; GeneralError.message is app_attest_unavailable.