Skip to main content

Create a job (org admin, allowlisted types only)

POST 

/api/v1/orgs/:org/jobs

Enqueues a background job. Requires org admin — a member with the user or viewer role is refused with 403.

Only allowlisted job types may be created through this endpoint, and the allowlist currently contains sleep alone. Every other type (email, webhook, aggregation, notification, the discovery family, …) is refused with 403: they are internal plumbing enqueued by SolidPing itself, and exposing them would hand any caller an arbitrary mail sender (email) and arbitrary server-side HTTP requests (webhook).

An unknown job type, or a config that is invalid for the requested type, is a 400 — never a 500.

Request

Responses

Job created