Sign in

v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Apps

Get Job Invocations

Get a specific job invocation for an app.

get/v2/apps/{app_id}/job-invocations/{job_invocation_id}

Path parameters

app_idstring required

The app ID

job_invocation_idstring required

The ID of the job invocation to retrieve.

Query parameters

job_namestring

The job name to list job invocations for.

Response

A JSON with key job_invocation

idstring
job_namestring
deployment_idstring
phase'UNKNOWN' | 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'SKIPPED'

The phase of the job invocation

created_atstring date-time
started_atstring date-time
completed_atstring date-time

Example response

{
  "id": "ba32b134-569c-4c0c-ba02-8ffdb0492ece",
  "job_name": "good-job",
  "deployment_id": "c020763f-ddb7-4112-a0df-7f01c69fc00b",
  "phase": "SUCCEEDED",
  "trigger": {
    "type": "MANUAL",
    "scheduled": {
      "schedule": {
        "cron": "0 0 * * *",
        "time_zone": "America/New_York"
      }
    },
    "manual": {
      "user": {
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "email": "user@example.com",
        "full_name": "John Doe"
      }
    }
  },
  "created_at": "2023-10-01T12:00:00Z",
  "started_at": "2023-10-01T12:05:00Z",
  "completed_at": "2023-10-01T12:10:00Z"
}