deploy.jobs.listList an app’s jobs with their schedule in words, next run and last result
Request syntax
GET /deploy/api/apps/{id}/jobsPath parameters
idRequiredstring
Constraints: uuid
Response
200 with `data`: `runnerInstanceId` (the machine that runs the jobs, or null before one has reported in) and `jobs` — each with id, name, schedule, scheduleDescription, command, service, timezone, enabled, timeoutSec, concurrency, nextRunAt (null when disabled), lastRun (status, trigger, exitCode, times; or null), createdAt and updatedAt.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
runnerInstanceIdAlwaysstring, may be null
The machine that runs the jobs; null before one has reported injobsAlwaysarray of object
The app’s jobsjobs[].idAlwaysstring
Job idjobs[].nameAlwaysstring
Name, unique in the appjobs[].scheduleAlwaysstring
Cron expression, in UTCjobs[].scheduleDescriptionAlwaysstring
The schedule in words, or why it cannot be readjobs[].commandAlwaysstring
Command run with /bin/sh -cjobs[].serviceAlwaysstring, may be null
Compose apps: the service it runs in; null: the published servicejobs[].timezoneAlwaysstring
Time zone of the schedule (UTC)jobs[].enabledAlwaysboolean
Whether it runs on its schedulejobs[].timeoutSecAlwaysnumber
Seconds a run may take before it is stoppedjobs[].concurrencyAlwaysone of skip, allow
skip: a due run is skipped while the previous one runs; allow: it starts anywayjobs[].nextRunAtAlwaysstring, may be null
When it runs next; null when disabledjobs[].lastRunAlwaysobject, may be null
Its newest run; null if it never ranjobs[].lastRun.idAlwaysstring
Run idjobs[].lastRun.statusAlwaysone of requested, running, succeeded, failed, timed_out, skipped, lost
requested, running, succeeded, failed, timed_out, skipped or lostjobs[].lastRun.triggerAlwaysone of schedule, manual
schedule or manual (run now)jobs[].lastRun.exitCodeAlwaysnumber, may be null
Exit code; null until it finishedjobs[].lastRun.startedAtAlwaysstring, may be null
When it startedjobs[].lastRun.finishedAtAlwaysstring, may be null
When it finishedjobs[].lastRun.createdAtAlwaysstring
When the run was recordedjobs[].createdAtAlwaysstring
When it was createdjobs[].updatedAtAlwaysstring
When it was last changed
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow deploy:DescribeJobs on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud deploy jobs list idcurl -X GET "https://console.platform-development.deutschecloud.app/deploy/api/apps/id/jobs" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_deploy_jobs_list.