Skip to content

Create a status page viewer account

POST
/status-pages/{id}/viewers
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. Accepts API keys with the status-pages:write scope, subject to current role and resource grants.

id
required
string
Media typeapplication/json
object
email
required
string
username
required
string
Examplegenerated
{
"email": "example",
"username": "example"
}

Resource created. The response body contains the created resource.

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"
}
}

The request is invalid. Check the supplied fields and values.

Authentication is missing or invalid.

The authenticated caller does not have permission to perform this operation.

No accessible resource matches the supplied identifier.

Username bereits vergeben