Docs

Type a word or a question. Esc closes the search.

Sign in Start free

Update status page access

Updates e-mail and IP allowlists for a status page and returns the resulting access policy.

PUT https://app.upfour.io/v1/status-pages/{pageID}/access
PUT https://app.upfour.io/v1/status-pages/{pageID}/access

A real request. Sending it changes data in your up4 account.

Authorization
AuthorizationA pls_ key. It stays in this browser tab. Needs status_page.write.
Path
Body
More fields1
access_email_codes Omitted leaves the e-mail-code setting as configured.

2 more fields are only available in JSON.

Sent directly from your browser to https://app.upfour.io/v1. Mutating calls get an automatic Idempotency-Key when the field is empty.

Request
Responsenot sent yet
Fill in a key and press Send request (⌘↵).
The answer appears here.
scope status_page.write stable returns 200

Parameters

FieldTypeDescription
pageID required uuid path parameter

Body

application/json required 3 fields

All other fields3 fields
access_email_allowliststring[] · nullable

Full addresses or @domain.tld entries. Omitted leaves the allowlist as configured.

access_email_codesboolean · nullable

Omitted leaves the e-mail-code setting as configured.

ip_allowliststring[]

IPv4, IPv6 or CIDR entries. Always applied: omitting it clears the list.

Returns

A successful request returns 200 with application/json.

Response fields 1 top-level fields
FieldTypeDescription
data StatusPageAccessPolicy
StatusPageAccessPolicy · 6 fields
FieldTypeDescription
access_email_allowlist string[] · nullable Full addresses or @domain.tld entries allowed to request an e-mail access code.
access_email_codes boolean
access_token_configured boolean
ip_allowlist string[] · nullable
status_page_id uuid
token_rotated_at string (date-time) · nullable

Errors

Only the errors this operation can return. Every error uses the same envelope.

Status Code Meaning
400 bad_request The request is malformed or fails validation.
404 not_found The requested resource does not exist or is outside the caller's scope.
403 permission_denied The credentials do not permit this action.

Every call can also return unauthorized (401), rate_limit_exceeded (429) or internal_error (500 / 502). See Responses and errors.