GET

Job Instance

API endpoint that allows jobs to be viewed or edited.

Pass the start_now url parameter to the POST method to enqueue the job immediately.

Use the delay field to create a test job with fake duration of work (in seconds).

Actions

/jobs/{id}/run/ (POST)

Run a job (add it to the queue).

/jobs/{id}/cancel/ (POST)

Cancel a job (terminate the background task)

GET /api/v2/jobs/768/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, DELETE, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 768,
    "details": "https://api.beluga.insectai.org/api/v2/jobs/768/?format=api",
    "name": "Sync captures for deployment 13",
    "delay": 0,
    "limit": 1000,
    "shuffle": true,
    "project": {
        "id": 23,
        "name": "Insectarium de Montréal",
        "details": "https://api.beluga.insectai.org/api/v2/projects/23/?format=api",
        "user_permissions": []
    },
    "deployment": {
        "id": 13,
        "name": "Rigaud",
        "details": "https://api.beluga.insectai.org/api/v2/deployments/13/?format=api",
        "user_permissions": []
    },
    "source_image_collection": null,
    "source_image_single": null,
    "pipeline": null,
    "status": "FAILURE",
    "created_at": "2024-06-24T11:41:44.462562",
    "updated_at": "2024-11-13T17:15:33.915993",
    "started_at": "2024-06-24T11:41:44.562103",
    "finished_at": "2025-10-10T00:38:09.503212",
    "duration": "40827384.941109",
    "progress": {
        "summary": {
            "status": "FAILURE",
            "progress": 0.0
        },
        "stages": [
            {
                "status": "STARTED",
                "progress": 0.0,
                "key": "data_storage_sync",
                "name": "data_storage_sync",
                "params": [
                    {
                        "name": "total_images",
                        "key": "total_images",
                        "category": "default",
                        "value": 0
                    }
                ]
            }
        ],
        "errors": [
            "Job #768 \"Sync captures for deployment 13\" failed: An error occurred (InvalidArgument) when calling the ListObjectsV2 operation: Unknown NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|"
        ],
        "logs": [
            "[2024-06-24 11:41:45] ERROR Job #768 \"Sync captures for deployment 13\" failed: An error occurred (InvalidArgument) when calling the ListObjectsV2 operation: Unknown NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|",
            "[2024-06-24 11:41:44] INFO Syncing captures for deployment #13 Quebec - Rigaud NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|",
            "[2024-06-24 11:41:44] INFO Changing status of job 768 to STARTED NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|",
            "[2024-06-24 11:41:44] INFO Running job #768 \"Sync captures for deployment 13\" (PENDING) NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|"
        ]
    },
    "logs": {
        "stdout": [
            "[2025-10-10 00:38:10] ERROR Job 768 has been pending for 1 year, 3 months with workers available, marking as failed",
            "[2025-10-10 00:38:10] WARNING Job 768 has been waiting for 1 year, 3 months with 1 worker(s) available. Task may be queued behind other jobs.",
            "[2025-10-10 00:38:09] ERROR Job 768 has been running for 1 year, 3 months, marking as failed (max runtime: 48 hours)",
            "[2024-06-24 11:41:45] ERROR Job #768 \"Sync captures for deployment 13\" failed: An error occurred (InvalidArgument) when calling the ListObjectsV2 operation: Unknown NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|",
            "[2024-06-24 11:41:44] INFO Syncing captures for deployment #13 Quebec - Rigaud NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|",
            "[2024-06-24 11:41:44] INFO Changing status of job 768 to STARTED NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|",
            "[2024-06-24 11:41:44] INFO Running job #768 \"Sync captures for deployment 13\" (PENDING) NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|"
        ],
        "stderr": [
            "Job 768 has been pending for 1 year, 3 months with workers available, marking as failed",
            "Job 768 has been running for 1 year, 3 months, marking as failed (max runtime: 48 hours)",
            "Job #768 \"Sync captures for deployment 13\" failed: An error occurred (InvalidArgument) when calling the ListObjectsV2 operation: Unknown NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|56faf96d643e|a9ed99f8b72fac36e6a77fb344c3723d|4bd2f8cad4585839|AMI%20Backend%20%28Staging%29|"
        ]
    },
    "job_type": {
        "name": "Data storage sync",
        "key": "data_storage_sync"
    },
    "data_export": null,
    "dispatch_mode": "internal",
    "result": null,
    "user_permissions": []
}