Skip to main content

Pre-filled "Add check" links

The check create page can be pre-filled from URL query parameters, so you can hand someone a single link that opens the new-check form with the target, schedule, and metadata already populated. This is ideal for "Add this to monitoring" buttons in your READMEs, runbooks, CLI output, and onboarding empty-states.

The form is only pre-filled — nothing is saved until the user reviews the values and clicks Create check. Pre-filling applies to the create page only (/checks/new); the edit page never reads query parameters.

URL shape

https://app.solidping.io/dash0/orgs/<org>/checks/new?<params>

Replace <org> with your organization slug and app.solidping.io with your own host if you self-host.

Supported parameters

ParameterExampleMaps to
checkTypecheckType=httpCheck type
checkNamecheckName=API%20healthName
checkSlugcheckSlug=api-healthSlug
checkPeriodcheckPeriod=60Check interval, in seconds
httpUrl / urlhttpUrl=https://example.comTarget URL
httpMethodhttpMethod=POSTHTTP method
hosthost=db.example.comHost
portport=5432Port
domaindomain=example.comDomain
usernameusername=probeUsername (HTTP: prefills the Basic Auth username)
databasedatabase=appDatabase
expectedStatusexpectedStatus=204Expected HTTP status
timeouttimeout=10Per-probe timeout, in seconds (1–30)
labellabel=env:prodLabel(s) — see below
regionregion=us1,eu2Regions — see below
groupgroup=productionGroup, by its slug
confirmationPeriodconfirmationPeriod=120Incident confirmation period, in seconds
recoveryPeriodrecoveryPeriod=120Incident recovery period, in seconds
sectionsection=flappingExpand + scroll to a collapsible section

Labels

Labels use key:value pairs. Repeat the parameter, or comma-separate the values, or both:

?label=env:prod&label=team:infra
?label=env:prod,team:infra

Regions

Regions are given by slug. Comma-separate or repeat the singular region parameter:

?region=us1,eu2
?region=us1&region=eu2

Deep-linking a section

The create form groups less-common options into collapsible sections. Pass section=<name> to open one and scroll to it on load — handy when a link is specifically about, say, flapping tuning:

?section=flapping

Section names: organization, dependencies, incident-tracking, flapping, advanced.

Example

Monitor an HTTP endpoint every 30 seconds, expecting a 204, tagged env:staging, in a group called edge:

https://app.solidping.io/dash0/orgs/acme/checks/new?checkType=http&url=https://staging.example.com/health&checkPeriod=30&expectedStatus=204&label=env:staging&group=edge

Unknown or malformed parameters are ignored, and an unrecognized group slug simply leaves the group unset — the form still opens.