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

{
    "id": 1208,
    "details": "https://api.beluga.insectai.org/api/v2/jobs/1208/?format=api",
    "name": "Starred - Binary",
    "delay": 0,
    "limit": null,
    "shuffle": true,
    "project": {
        "id": 18,
        "name": "Vermont Atlas of Life",
        "details": "https://api.beluga.insectai.org/api/v2/projects/18/?format=api",
        "user_permissions": []
    },
    "deployment": null,
    "source_image_collection": {
        "id": 11,
        "name": "Starred Images",
        "details": "https://api.beluga.insectai.org/api/v2/captures/collections/11/?format=api",
        "method": "starred",
        "user_permissions": []
    },
    "source_image_single": null,
    "pipeline": {
        "id": 15,
        "details": "https://api.beluga.insectai.org/api/v2/ml/pipelines/15/?format=api",
        "name": "Moth / Non-Moth Classifier",
        "slug": "moth_binary",
        "description": "Trained on April 17, 2024",
        "version": 1,
        "version_name": "",
        "created_at": "2025-01-27T10:53:11.287453",
        "updated_at": "2026-04-01T17:09:36.958282",
        "user_permissions": []
    },
    "status": "SUCCESS",
    "created_at": "2025-01-27T11:19:27.878480",
    "updated_at": "2025-01-27T11:20:24.719352",
    "started_at": "2025-01-27T11:19:31.070085",
    "finished_at": "2025-01-27T11:20:24.719230",
    "duration": "53.649145",
    "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": 20
                    }
                ]
            },
            {
                "status": "SUCCESS",
                "progress": 1.0,
                "key": "process",
                "name": "Process",
                "params": [
                    {
                        "name": "Processed",
                        "key": "processed",
                        "category": "default",
                        "value": 20
                    },
                    {
                        "name": "Remaining",
                        "key": "remaining",
                        "category": "default",
                        "value": 0
                    },
                    {
                        "name": "Failed",
                        "key": "failed",
                        "category": "default",
                        "value": 0
                    }
                ]
            },
            {
                "status": "SUCCESS",
                "progress": 1.0,
                "key": "results",
                "name": "Results",
                "params": [
                    {
                        "name": "Captures",
                        "key": "captures",
                        "category": "default",
                        "value": 20
                    },
                    {
                        "name": "Detections",
                        "key": "detections",
                        "category": "default",
                        "value": 115
                    },
                    {
                        "name": "Classifications",
                        "key": "classifications",
                        "category": "default",
                        "value": 115
                    }
                ]
            }
        ],
        "errors": [],
        "logs": []
    },
    "logs": {
        "stdout": [
            "[2025-01-27 11:20:25] INFO Finished job #1208 \"Starred - Binary\" (SUCCESS)",
            "[2025-01-27 11:20:24] INFO Finished job #1208 \"Starred - Binary\" (SUCCESS)",
            "[2025-01-27 11:20:24] INFO Changing status of job 1208 from STARTED to SUCCESS",
            "[2025-01-27 11:20:24] INFO All tasks completed for job 1208",
            "[2025-01-27 11:20:23] INFO All tasks completed for job 1208",
            "[2025-01-27 11:20:23] INFO Waiting for batch 5 to finish saving results (sub-task 77a1ea57-1e25-4b9d-9d22-bf3c26be52e6)",
            "[2025-01-27 11:20:22] INFO Waiting for batch 5 to finish saving results (sub-task 77a1ea57-1e25-4b9d-9d22-bf3c26be52e6)",
            "[2025-01-27 11:20:22] INFO Checking the status of 1 remaining sub-tasks that are still saving results.",
            "[2025-01-27 11:20:22] INFO Processed 100% of images successfully.",
            "[2025-01-27 11:20:22] INFO Saving results for batch 5 in sub-task 77a1ea57-1e25-4b9d-9d22-bf3c26be52e6",
            "[2025-01-27 11:20:21] INFO Saving results for batch 5 in sub-task 77a1ea57-1e25-4b9d-9d22-bf3c26be52e6",
            "[2025-01-27 11:20:21] INFO Processed image batch 5 in 5.84s",
            "[2025-01-27 11:20:19] INFO Processed image batch 5 in 5.84s",
            "[2025-01-27 11:20:18] INFO Processed image batch 5 in 5.84s",
            "[2025-01-27 11:20:17] INFO Processed image batch 5 in 5.84s",
            "[2025-01-27 11:20:15] INFO Processed image batch 5 in 5.84s",
            "[2025-01-27 11:20:15] INFO Pipeline results returned 4 images, 23 detections, 23 classifications",
            "[2025-01-27 11:20:14] INFO Pipeline results returned 4 images, 23 detections, 23 classifications",
            "[2025-01-27 11:20:11] INFO Sending 4 images to Pipeline #15 \"Moth / Non-Moth Classifier\" (moth_binary) v1",
            "[2025-01-27 11:20:11] INFO Using processing service with latency 0.6285: #1 \"Rolnick Lab shared inference services\" at https://ml.dev.insectai.org/",
            "[2025-01-27 11:20:09] INFO Processing image batch 5 of 5",
            "[2025-01-27 11:20:09] INFO Saving results for batch 4 in sub-task 92d5d8aa-66e9-4368-91de-e5e82777f675",
            "[2025-01-27 11:20:09] INFO Processed image batch 4 in 5.36s",
            "[2025-01-27 11:20:08] INFO Processed image batch 4 in 5.36s",
            "[2025-01-27 11:20:08] INFO Pipeline results returned 4 images, 10 detections, 10 classifications",
            "[2025-01-27 11:20:05] INFO Sending 4 images to Pipeline #15 \"Moth / Non-Moth Classifier\" (moth_binary) v1",
            "[2025-01-27 11:20:05] INFO Using processing service with latency 0.6204: #1 \"Rolnick Lab shared inference services\" at https://ml.dev.insectai.org/",
            "[2025-01-27 11:20:04] INFO Using processing service with latency 0.6204: #1 \"Rolnick Lab shared inference services\" at https://ml.dev.insectai.org/",
            "[2025-01-27 11:20:03] INFO Processing image batch 4 of 5",
            "[2025-01-27 11:20:03] INFO Saving results for batch 3 in sub-task 5df54116-1675-49b2-825d-347b1239a767",
            "[2025-01-27 11:20:02] INFO Processed image batch 3 in 2.41s",
            "[2025-01-27 11:20:02] ERROR Method Not Allowed",
            "[2025-01-27 11:20:02] INFO Sending 4 images to Pipeline #15 \"Moth / Non-Moth Classifier\" (moth_binary) v1",
            "[2025-01-27 11:20:01] INFO Sending 4 images to Pipeline #15 \"Moth / Non-Moth Classifier\" (moth_binary) v1",
            "[2025-01-27 11:20:01] INFO Using processing service with latency 0.6375: #2 \"Shared models on DRAC\" at http://ml.dev.insectai.org",
            "[2025-01-27 11:20:00] INFO Processing image batch 3 of 5",
            "[2025-01-27 11:20:00] INFO Saving results for batch 2 in sub-task 1c6051c2-255d-4128-a6d6-dcaa1a70fa3f",
            "[2025-01-27 11:19:59] INFO Processed image batch 2 in 15.32s",
            "[2025-01-27 11:19:59] INFO Pipeline results returned 4 images, 66 detections, 66 classifications",
            "[2025-01-27 11:19:55] INFO Sending 4 images to Pipeline #15 \"Moth / Non-Moth Classifier\" (moth_binary) v1",
            "[2025-01-27 11:19:55] INFO Using processing service with latency 0.622: #1 \"Rolnick Lab shared inference services\" at https://ml.dev.insectai.org/",
            "[2025-01-27 11:19:52] INFO Processing image batch 2 of 5",
            "[2025-01-27 11:19:51] INFO Processing image batch 2 of 5",
            "[2025-01-27 11:19:50] INFO Processing image batch 2 of 5",
            "[2025-01-27 11:19:47] INFO Processing image batch 2 of 5",
            "[2025-01-27 11:19:46] INFO Processing image batch 2 of 5",
            "[2025-01-27 11:19:45] INFO Processing image batch 2 of 5",
            "[2025-01-27 11:19:44] INFO Processing image batch 2 of 5",
            "[2025-01-27 11:19:42] INFO Saving results for batch 1 in sub-task a9ac67c4-c3f0-4877-aede-bf53a9ae61e4",
            "[2025-01-27 11:19:41] INFO Saving results for batch 1 in sub-task a9ac67c4-c3f0-4877-aede-bf53a9ae61e4",
            "[2025-01-27 11:19:37] INFO Saving results for batch 1 in sub-task a9ac67c4-c3f0-4877-aede-bf53a9ae61e4",
            "[2025-01-27 11:19:36] INFO Saving results for batch 1 in sub-task a9ac67c4-c3f0-4877-aede-bf53a9ae61e4",
            "[2025-01-27 11:19:36] INFO Processed image batch 1 in 4.52s",
            "[2025-01-27 11:19:36] INFO Pipeline results returned 4 images, 16 detections, 16 classifications",
            "[2025-01-27 11:19:33] INFO Sending 4 images to Pipeline #15 \"Moth / Non-Moth Classifier\" (moth_binary) v1",
            "[2025-01-27 11:19:33] INFO Using processing service with latency 0.6557: #1 \"Rolnick Lab shared inference services\" at https://ml.dev.insectai.org/",
            "[2025-01-27 11:19:32] INFO Processing image batch 1 of 5",
            "[2025-01-27 11:19:31] INFO Processing image batch 1 of 5",
            "[2025-01-27 11:19:31] INFO Shuffling images",
            "[2025-01-27 11:19:31] INFO Found 20 out of 20 images to process",
            "[2025-01-27 11:19:31] INFO Filtering images that have already been processed by pipeline #15 \"Moth / Non-Moth Classifier\" (moth_binary) v1",
            "[2025-01-27 11:19:30] INFO Changing status of job 1208 from PENDING to STARTED",
            "[2025-01-27 11:19:29] INFO Changing status of job 1208 from PENDING to STARTED",
            "[2025-01-27 11:19:28] INFO Running job #1208 \"Starred - Binary\" (PENDING)"
        ],
        "stderr": [
            "Method Not Allowed"
        ]
    },
    "job_type": {
        "name": "ML pipeline",
        "key": "ml"
    },
    "data_export": null,
    "dispatch_mode": "internal",
    "result": null,
    "user_permissions": []
}