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/1245/?format=api
{ "id": 1245, "details": "https://api.beluga.insectai.org/api/v2/jobs/1245/?format=api", "name": "Starred images, new job system", "delay": 0, "limit": null, "shuffle": true, "project": { "id": 84, "name": "Pennsylvania Tebufenozide Impacts Study", "details": "https://api.beluga.insectai.org/api/v2/projects/84/?format=api", "user_permissions": [] }, "deployment": null, "source_image_collection": { "id": 66, "name": "Starred Images", "details": "https://api.beluga.insectai.org/api/v2/captures/collections/66/?format=api", "method": "starred", "user_permissions": [] }, "source_image_single": null, "pipeline": { "id": 4, "details": "https://api.beluga.insectai.org/api/v2/ml/pipelines/4/?format=api", "name": "World moths", "slug": "global_moths_2024", "description": "", "version": 1, "version_name": "", "created_at": "2024-08-28T21:59:10.627394", "updated_at": "2026-04-01T17:09:36.922817", "user_permissions": [] }, "status": "FAILURE", "created_at": "2025-10-23T19:28:12.332814", "updated_at": "2025-10-23T19:28:40.053215", "started_at": "2025-10-23T19:28:12.477251", "finished_at": "2025-10-23T19:28:40.053037", "duration": "27.575786", "progress": { "summary": { "status": "FAILURE", "progress": 0.3333333333333333 }, "stages": [ { "status": "SUCCESS", "progress": 1.0, "key": "collect", "name": "Collect", "params": [ { "name": "Total Images", "key": "total_images", "category": "default", "value": 14 } ] }, { "status": "CREATED", "progress": 0.0, "key": "process", "name": "Process", "params": [ { "name": "Processed", "key": "processed", "category": "default", "value": "" }, { "name": "Remaining", "key": "remaining", "category": "default", "value": "" }, { "name": "Failed", "key": "failed", "category": "default", "value": "" } ] }, { "status": "CREATED", "progress": 0.0, "key": "results", "name": "Results", "params": [ { "name": "Captures", "key": "captures", "category": "default", "value": "" }, { "name": "Detections", "key": "detections", "category": "default", "value": "" }, { "name": "Classifications", "key": "classifications", "category": "default", "value": "" } ] } ], "errors": [], "logs": [] }, "logs": { "stdout": [ "[2025-10-23 19:28:14] INFO Finished job #1245 \"Starred images, new job system\" (STARTED)", "[2025-10-23 19:28:14] INFO Continue processing the remaining 14 process image request subtasks.", "[2025-10-23 19:28:14] INFO Submitted batch image processing tasks (task_name=process_pipeline_request) in 1.85s", "[2025-10-23 19:28:14] INFO Submitted 14 batch image processing task(s).", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=f102dbe4-1f37-4575-b48d-a1c8f4da0d2a, task_name=process_pipeline_request) for task f102dbe4-1f37-4575-b48d-a1c8f4da0d2a", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=254b82be-8e04-4f46-83c1-67302de85525, task_name=process_pipeline_request) for task 254b82be-8e04-4f46-83c1-67302de85525", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=2472a91a-82f5-4933-852a-adec7b3f1ed5, task_name=process_pipeline_request) for task 2472a91a-82f5-4933-852a-adec7b3f1ed5", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=1ddc74ba-f854-4d17-b47e-16cb0109303a, task_name=process_pipeline_request) for task 1ddc74ba-f854-4d17-b47e-16cb0109303a", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=51192700-09a2-41e2-a35c-ed80e4c39dc0, task_name=process_pipeline_request) for task 51192700-09a2-41e2-a35c-ed80e4c39dc0", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=31a744b4-8347-4b45-adaf-dc28ad7b10ce, task_name=process_pipeline_request) for task 31a744b4-8347-4b45-adaf-dc28ad7b10ce", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=3440fdfa-eac8-47fb-b435-fb3774bf2e48, task_name=process_pipeline_request) for task 3440fdfa-eac8-47fb-b435-fb3774bf2e48", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=d97dc8ff-0a4d-498e-ac41-f41f0f9bb3bb, task_name=process_pipeline_request) for task d97dc8ff-0a4d-498e-ac41-f41f0f9bb3bb", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=fe2bced3-3c79-4702-b1be-7ea56c276660, task_name=process_pipeline_request) for task fe2bced3-3c79-4702-b1be-7ea56c276660", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=d065d613-1649-46f7-add2-aaabf5667fb4, task_name=process_pipeline_request) for task d065d613-1649-46f7-add2-aaabf5667fb4", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=578bc2dd-a8c6-4592-91ae-5f915f308a35, task_name=process_pipeline_request) for task 578bc2dd-a8c6-4592-91ae-5f915f308a35", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=e8b1865f-54b0-4388-a777-d72b6f81f7b2, task_name=process_pipeline_request) for task e8b1865f-54b0-4388-a777-d72b6f81f7b2", "[2025-10-23 19:28:14] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=b60d60a0-6c5a-499d-8802-e9621e831752, task_name=process_pipeline_request) for task b60d60a0-6c5a-499d-8802-e9621e831752", "[2025-10-23 19:28:13] INFO Created MLTaskRecord MLTaskRecord(job=1245, task_id=77b36269-7e96-43d5-8bec-0bdb1770f6b4, task_name=process_pipeline_request) for task 77b36269-7e96-43d5-8bec-0bdb1770f6b4", "[2025-10-23 19:28:13] INFO Found 0 existing detections.", "[2025-10-23 19:28:13] INFO Reprocessing of existing detections is disabled, sending images without detections.", "[2025-10-23 19:28:13] INFO Sending 14 images to Pipeline #4 \"World moths\" (global_moths_2024) v1", "[2025-10-23 19:28:13] INFO Using pipeline config: {'request_source_image_batch_size': 8}", "[2025-10-23 19:28:13] INFO Using project: #84 Pennsylvania Tebufenozide Impacts Study", "[2025-10-23 19:28:12] INFO Processing 14 images with pipeline global_moths_2024", "[2025-10-23 19:28:12] INFO Shuffling images", "[2025-10-23 19:28:12] INFO Found 14 out of 14 images to process", "[2025-10-23 19:28:12] INFO Filtering images that have already been processed by pipeline #4 \"World moths\" (global_moths_2024) v1", "[2025-10-23 19:28:12] INFO Changing status of job 1245 from PENDING to STARTED", "[2025-10-23 19:28:12] INFO Running job #1245 \"Starred images, new job system\" (PENDING)" ], "stderr": [] }, "job_type": { "name": "ML pipeline", "key": "ml" }, "data_export": null, "dispatch_mode": "internal", "result": null, "user_permissions": [] }