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/568/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, DELETE, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 568,
    "details": "https://api.beluga.insectai.org/api/v2/jobs/568/?format=api",
    "name": "Favorites Test",
    "delay": 0,
    "limit": 100,
    "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": null,
    "source_image_collection": {
        "id": 28,
        "name": "Starred Images",
        "details": "https://api.beluga.insectai.org/api/v2/captures/collections/28/?format=api",
        "method": "starred",
        "user_permissions": []
    },
    "source_image_single": null,
    "pipeline": {
        "id": 3,
        "details": "https://api.beluga.insectai.org/api/v2/ml/pipelines/3/?format=api",
        "name": "Quebec & Vermont moths",
        "slug": "quebec_vermont_moths_2023",
        "description": "",
        "version": 1,
        "version_name": "",
        "created_at": "2023-11-27T23:26:16.449157",
        "updated_at": "2026-04-01T17:09:36.520322",
        "user_permissions": []
    },
    "status": "SUCCESS",
    "created_at": "2024-04-01T19:05:12.540969",
    "updated_at": "2024-11-13T17:15:34.391060",
    "started_at": "2024-04-01T19:05:12.631586",
    "finished_at": "2024-04-01T19:05:32.626469",
    "duration": "19.994883",
    "progress": {
        "summary": {
            "status": "SUCCESS",
            "progress": 1.0
        },
        "stages": [
            {
                "status": "SUCCESS",
                "progress": 1.0,
                "key": "collect",
                "name": "Collect",
                "params": [
                    {
                        "name": "Total Images",
                        "key": "total_images",
                        "category": "default",
                        "value": 2
                    }
                ]
            },
            {
                "status": "SUCCESS",
                "progress": 1.0,
                "key": "process",
                "name": "Process",
                "params": [
                    {
                        "name": "Processed",
                        "key": "processed",
                        "category": "default",
                        "value": 4
                    },
                    {
                        "name": "Remaining",
                        "key": "remaining",
                        "category": "default",
                        "value": -2
                    },
                    {
                        "name": "Detections",
                        "key": "detections",
                        "category": "default",
                        "value": 24
                    },
                    {
                        "name": "Classifications",
                        "key": "classifications",
                        "category": "default",
                        "value": 24
                    }
                ]
            },
            {
                "status": "SUCCESS",
                "progress": 1.0,
                "key": "results",
                "name": "Results",
                "params": [
                    {
                        "name": "Objects created",
                        "key": "objects_created",
                        "category": "default",
                        "value": 35
                    }
                ]
            }
        ],
        "errors": [],
        "logs": [
            "[2024-04-01 19:05:32] INFO Finished job #568 \"Favorites Test\" (SUCCESS) NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:32] INFO Changing status of job 568 to SUCCESS NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:32] INFO Created 35 objects NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:30] INFO Saving results NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:30] INFO Found 24 classifications NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:30] INFO Found 24 detections NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Sending 2 images to ML backend quebec_vermont_moths_2023 NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Shuffling images NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Found 2 out of 2 images to process NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Filtering images that have already been processed by pipeline #3 Quebec/Vermont Moths NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Changing status of job 568 to STARTED NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Running job #568 \"Favorites Test\" (PENDING) NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|"
        ]
    },
    "logs": {
        "stdout": [
            "[2024-04-01 19:05:32] INFO Finished job #568 \"Favorites Test\" (SUCCESS) NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:32] INFO Changing status of job 568 to SUCCESS NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:32] INFO Created 35 objects NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:30] INFO Saving results NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:30] INFO Found 24 classifications NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:30] INFO Found 24 detections NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Sending 2 images to ML backend quebec_vermont_moths_2023 NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Shuffling images NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Found 2 out of 2 images to process NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Filtering images that have already been processed by pipeline #3 Quebec/Vermont Moths NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Changing status of job 568 to STARTED NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|",
            "[2024-04-01 19:05:12] INFO Running job #568 \"Favorites Test\" (PENDING) NR-LINKING|MzUxNDA2MHxBUE18QVBQTElDQVRJT058MTA1NTk1NTg3NQ|6cee5cdcd05c|337a02e337430dc88c9df5f334ff3027|7b43099cebf2adcf|AMI%20Backend%20%28Staging%29|"
        ],
        "stderr": []
    },
    "job_type": {
        "name": "ML pipeline",
        "key": "ml"
    },
    "data_export": null,
    "dispatch_mode": "internal",
    "result": null,
    "user_permissions": []
}