Set or rotate the shared password
PUT
/status-pages/{id}/shared-password
const url = 'https://api.perstat.io/status-pages/example/shared-password';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"password":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.perstat.io/status-pages/example/shared-password \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "password": "example" }'Sets or rotates the shared password of a status page. The password must be at least 12 characters and is stored only as a hash; rotation immediately invalidates all existing shared access sessions. Setting the password is separate from enabling the shared-password access mode in the page settings.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
password
required
Klartext-Kennwort (min. 12 Zeichen). Wird Argon2-gehasht; at rest liegt nur der Hash. Wird NIE im DTO zurückgegeben.
string
Examplegenerated
{ "password": "example"}Responses
Section titled “Responses”Kennwort < 12 Zeichen