Skip to main content

Documentation

Complete guide to setting up website monitoring with PingZen. API documentation, code examples, and best practices.

Workspaces

Workspaces let you separate monitoring into isolated spaces. Each workspace has its own monitors, alerts, incidents, and status pages.

When to Use

Different Projects

Separate monitoring between different projects or products.

Environments

Production, Staging, Development — each in its own workspace.

Separation

Separate monitoring by context — personal, work, hobby projects.

Clients

For agencies: a separate workspace for each client.

Features

Full Isolation

Monitors, alerts, and incidents don’t overlap between workspaces.

Quick Switching

Switch between workspaces with one click in the sidebar.

Default Workspace

Set the workspace that opens when you log in.

How to Create

  1. Click on the current workspace name in the sidebar
  2. Select “Manage Workspaces”
  3. Click “Add Workspace”
  4. Enter a name and description
  5. Switch to the new workspace and add monitors

Export & Import Monitors (CSV)

The Workspaces page is also the home of monitor backup and migration:

  • Export monitors (header button) — downloads every monitor from all your workspaces as one CSV file. The per-card download icon exports just that workspace. Available to every role, including viewers; secret fields (passwords, tokens) are never included.
  • Import monitors (header button) — opens the import dialog. Drop a CSV (or browse), pick a target — a specific workspace or route by the file’s workspace column — and the dialog immediately shows a preview: which rows would be created, skipped as duplicates, or fail, and why. Nothing is created until you confirm.

The preview is an estimate — monitor-name conflicts and plan limits are checked during the actual import. A large import runs row by row and can take a few minutes; keep the window open.

Files from UptimeRobot (bulk-upload template), StatusCake (Export Settings) and HetrixTools are accepted as-is — no column renaming. Only the url column is required. Importing needs the owner or editor role in the target workspace; up to 500 rows / 1 MB per file. If some rows fail, Download error rows gives you just the failures with reasons — fix and re-upload. Details and the API endpoints: API Reference.

Team & Sharing

Share a workspace with colleagues so you can monitor together. Available on every plan, the Free one included.

Everyone works inside the workspace owner’s plan limits — a teammate on the Free plan still operates within your monitor and alert quotas while inside your workspace.

How Many People You Can Add

PlanTotal seatsColleagues
Free32
Pro54
Business1514
Enterprise5049

The owner takes one seat. Unclaimed invitations hold a seat too, until they are accepted, revoked, or expire.

Roles

ActionOwnerEditorViewer
View dashboard, monitors, incidents, statistics
Create / edit / delete monitors, run checks, reorder
Create and manage their own alerts
See or edit other members’ alerts
Status pages, maintenance, scheduled reports
Invite / remove members, change roles

Alerts are personal — each member configures and receives their own notifications, and no one can see another member’s alerts.

Heartbeat monitors follow the same roles: a viewer sees them, an editor creates, edits, pauses, and deletes them.

How to Add a User

  1. Open the workspace selector in the sidebar, then “Manage Workspaces”.
  2. On a workspace you own, click the members (👥) icon.
  3. Click “Invite member”, pick a role, and choose one of the two ways.

By email — when your colleague already has a PingZen account on that address. Access is granted right away.

We send them no email — tell them yourself, otherwise they simply won’t notice the new workspace in their switcher.

By link — when they have no account yet, or you don’t know which email they signed up with. PingZen gives you a one-time link valid for 14 days; send it over any messenger. Your colleague signs in with email, Google, Yandex, or Telegram, confirms joining on the screen that follows, and lands in the workspace. The link is shown once, so copy it immediately.

Removing a Member or Revoking an Invitation

Remove a member from the same dialog. Access is revoked immediately, and any alerts they created in that workspace are deactivated.

An unused invite link can be revoked in the same place — it stops working at once and frees the seat.

Workspaces API

Manage workspaces via REST API.

GET/api/v1/workspaces

List user's workspaces

POST/api/v1/workspaces

Create workspace

PUT/api/v1/workspaces/:id

Update workspace

DELETE/api/v1/workspaces/:id

Delete workspace (empty only)

POST/api/v1/workspaces/:id/set-default

Set default workspace

GET/api/v1/workspaces/:id/members

List workspace members

POST/api/v1/workspaces/:id/members

Invite a member by email (owner only)

PATCH/api/v1/workspaces/:id/members/:member_id

Change a member's role (owner only)

DELETE/api/v1/workspaces/:id/members/:member_id

Remove a member or revoke an invitation (owner only)

POST/api/v1/workspaces/:id/invites

Create a one-time invite link valid for 14 days — works for people without an account yet (owner only)

POST/api/v1/workspaces/invites/accept

Accept an invite link

Common Questions

What protocols can I monitor?

PingZen supports 23 protocols: HTTP/HTTPS, WebSocket (WS/WSS), TCP, UDP, ICMP Ping, gRPC, DNS, WHOIS, SSL certificates, Email (SMTP/IMAP/POP3), FTP/FTPS, DNSBL, PageSpeed, SOCKS5, MTProxy, API Check, and Transaction. You can monitor websites, APIs, servers, databases, and any network service.

How fast can I get alerts?

Telegram alerts are delivered within 1-2 seconds of detection. Slack and Discord notifications arrive almost instantly. You can configure multiple alert channels for redundancy.

Can I organize monitors by project?

Yes! PingZen supports workspaces, which let you organize monitors by project, environment, or team. Each workspace can have its own alert configurations and team members.

Is there an API for automation?

Absolutely. PingZen provides a full REST API with OpenAPI documentation. You can create, update, and delete monitors programmatically.

How do status pages work?

Status pages are public, branded pages showing your services' uptime. You can display real-time status and allow customers to subscribe for updates.

What happens if I reach my monitor limit?

We'll notify you when approaching your limit. You can pause some monitors or contact us for increased capacity. We never stop monitoring without warning, ensuring your critical services stay protected.

Ready to stop missing downtime?

Join thousands of teams who trust PingZen. Setup takes 30 seconds.