Create a status page viewer account
POST
/status-pages/{id}/viewers
const url = 'https://api.perstat.io/status-pages/example/viewers';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"email":"example","username":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.perstat.io/status-pages/example/viewers \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "email": "example", "username": "example" }'Creates a login for a private status page. The password is generated server-side and returned exactly once in the response; only a hash is stored at rest. Returns 409 when the username is already taken on this page. Requires project management rights.
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
email
required
string
username
required
string
Examplegenerated
{ "email": "example", "username": "example"}Responses
Section titled “Responses”Media typeapplication/json
object
password
required
Generiertes Klartext-Passwort — wird NUR HIER, EINMALIG zurückgegeben. At rest liegt ausschließlich der Argon2-Hash.
string
viewer
required
object
created_at_unix
required
integer format: int64
email
required
string
id
required
Public_id (spv_…).
string
last_login_at_unix
Letzter erfolgreicher Login (Unix-Sekunden), null falls noch nie.
integer | null format: int64
username
required
string
Examplegenerated
{ "password": "example", "viewer": { "created_at_unix": 1, "email": "example", "id": "example", "last_login_at_unix": 1, "username": "example" }}Username bereits vergeben