Trigger cron job
POSThttps://api.instacloud.com/projects/{projectId}/cron-jobs/{id}/runs
Token scope: account · org · project — read-only tokens refused (not a GET).
Trigger a run now. Requires Idempotency-Key. Gated — cron.run. 403 also when the org is billing-suspended.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | |
id | path | string | yes | |
idempotency-key | header | string | yes | dedupes a retried trigger onto the same run |
Responses
202
accepted (runId) — or approval_required from the governance gate
400
missing, blank, or over-255-character Idempotency-Key (a paused job is still triggerable: pause stops the clock, not a manual run)
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
403
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
409
a run with this Idempotency-Key is still being created — retry
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |