v8

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

List Job Invocations

List all job invocations for an app.

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

Path parameters

app_idstring required

The app ID

Query parameters

job_namesSchema[]

The job names to list job invocations for.

deployment_idstring

The deployment ID

pageinteger

Which 'page' of paginated results to return.

per_pageinteger

Number of items returned per page

Response

A JSON with key job_invocations

Example response

{
  "job_invocations": [
    {
      "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"
    }
  ],
  "links": {
    "pages": {
      "last": "https://api.digitalocean.com/v2/images?page=2",
      "next": "https://api.digitalocean.com/v2/images?page=2"
    }
  }
}