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
- 201
- 400
- 403
Job created
Validation error
Caller is not an org admin, or the job type is not on the public-creation allowlist.