Get cron job
GEThttps://api.instacloud.com/projects/{projectId}/cron-jobs/{id}
Token scope: account · org · project — read-only tokens allowed.
Read one cron job. Header values are write-only; request gives the method, the header names, and the secret each secret-backed header names.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | |
id | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
job | object | yes | A cron schedule. Header values are write-only; `request` describes the stored request without them. |
job.id | string | yes | |
job.project_id | string | yes | |
job.branch_id | string | yes | |
job.branch | string | yes | branch name, joined for readability — the id is the identity |
job.name | string | yes | |
job.expression | string | yes | |
job.timezone | string | yes | UTC in v1, so preview and the materializer can never disagree |
job.enabled | boolean | yes | |
job.revision | integer | yes | the If-Match guard for PATCH |
job.next_run_at | string | null | yes | |
job.target | object | yes | Where the job sends its request. An internal target names the SERVICE, never a URL: the worker resolves the live route at send time, so a redeploy or a region move cannot leave a job firing at a dead host. |
job.request | object | yes | The non-secret description of the job’s request. |
job.request.method | "GET" | "POST" | yes | |
job.request.headerNames | string[] | yes | names only, literal and secret-backed alike — never values |
job.request.secretRefs | object | yes | header name → secret NAME for the secret-backed headers. Names are not credentials, so they are returned: an edit can re-send these as they are, where a literal header’s value must be supplied again. |
job.request_timeout_ms | integer | yes | |
job.retry_policy | object | yes | |
job.retry_policy.platformMaxRetries | integer | no | retries for failures where nothing was sent (wake/transport). Default 2. |
job.retry_policy.applicationMaxRetries | integer | no | retries for a non-2xx answer. Default 0 — a broken endpoint should not be hammered. |
job.retry_policy.retryableStatuses | integer[] | no | e.g. [429, 503]; empty means none |
job.retry_policy.maxRunAgeMs | integer | no | give up on the run once it is this old, whatever the retry budget says |
job.created_at | string | yes | |
job.updated_at | string | yes |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |