Skip to main content
POST
Course-wide Hide Pria for everyone toggle

Body

application/json

Either a fresh signed launch (params/launch_token/nonce/timestamp, as verified by /api/auth/sdk-verify) OR a ticket minted earlier by this same endpoint or by POST /api/auth/getInstitutionsForContextid — never both required. When both a ticket and a launch proof are sent, the ticket wins and the launch proof is ignored. A ticket carries the same identity/course facts as the launch it came from for up to 4 hours (design 2026-09-28 D4/D7), so a teacher can return to the panel after the 10-minute launch signature has expired.

params
object

Launch parameters, when authenticating by fresh launch (see SdkVerifyRequest).

launch_token
string

HMAC-SHA256 token returned from sdk-sign, when authenticating by fresh launch.

nonce
string

The nonce returned from sdk-sign, when authenticating by fresh launch.

timestamp
integer

The timestamp returned from sdk-sign, when authenticating by fresh launch.

ticket
string

A course ticket, when authenticating by ticket instead of a fresh launch.

hidden
boolean
default:true

Set the course-wide hide (default). false shows Pria again.

Response

Preference saved

success
boolean
Example:

true

hidden
boolean
ticket
string | null

By ticket: the SAME ticket handed back unchanged (a ticket never renews itself). By a fresh launch: a freshly minted 4-hour course ticket, so the caller can act again without re-launching. null in the rare case no ticket could be minted (for example, an over-long course id); the caller keeps using its launch proof.