Skip to main content
curl -X PATCH https://api.dronebundle.com/v1/projects/01964c6b-7a3e-7f00-8000-abc123def456/jobs/019d4350-a1b2-7c3d-8e4f-567890abcdef \
  -H "Authorization: Bearer v1_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "priority": "medium",
    "capture_types": ["drone_inspection", "thermal_inspection"]
  }'
{
  "message": "Job updated"
}
Requires an API key with full_access scope. All fields are optional. Only include the fields you want to change.

Path parameters

projectId
string
required
The unique identifier of the project.
jobId
string
required
The unique identifier of the job.

Body

name
string
Job name. 1 to 100 characters.
description
string
Job description. Max 1000 characters.
type
string
Job type. Must match one of the job types configured in your workspace.
status
string
Job status. One of: draft, not_started, planned, in_progress, completed, on_hold, weather_delayed, technical_issues, cancelled, aborted, other.
Your workspace may show custom display names for these statuses in the dashboard. The API always uses the predefined values listed above. Use other with other_status_reason for statuses that don’t map to a predefined value.
priority
string
Priority level. One of: low, medium, high.
job_pattern
string
Either one_time or recurring. Changing this will regenerate job occurrences.
start_date
string
Start date in ISO 8601 format. Cannot be more than 6 months in the past.
end_date
string | null
End date in ISO 8601 format. Must be on or after start_date. Set to null to clear.
latitude
number | null
Latitude of the job location. Between -90 and 90. Must be provided together with longitude. Set both to null to clear.
longitude
number | null
Longitude of the job location. Between -180 and 180. Must be provided together with latitude. Set both to null to clear.
inspection_notes
string
Notes for the inspection. Max 2000 characters.
capture_types
string[] | null
Array of capture types. Valid values: drone_inspection, thermal_inspection, video_capture, 3d_mapping, lidar_scan, orthomosaic, ground_smartphone, ground_360, panorama. Max 20 items, no duplicates. Set to null to clear.
external_id
string | null
Your own identifier for this job. Max 255 characters. Set to null to clear.
other_status_reason
string
Required when status is other. 1 to 200 characters.

Recurring job fields

These fields only apply when job_pattern is recurring. Changing any of these will regenerate job occurrences.
recurring_frequency
string | null
Recurrence frequency. One of: daily, weekly, monthly, yearly, flexible. Set to null to clear.
recurring_interval
number | null
Repeat every N periods. Between 1 and 365. Cannot be used with flexible frequency. Set to null to clear.
selected_days_of_week
number[] | null
Days of the week. Array of numbers where 0 = Sunday, 6 = Saturday. Max 7 values. Set to null to clear.
week_of_month
number | null
Which week of the month. One of: 1, 2, 3, 4, or -1 (last week). Set to null to clear.
weeks_of_month
number[] | null
Multiple weeks of the month. Array of values: 1, 2, 3, 4, or -1 (last week). Max 5 values, no duplicates. Set to null to clear.
flights_per_occurrence
number | null
Number of flights per occurrence. Between 1 and 10. Set to null to clear.

Response

message
string
Confirmation message.
curl -X PATCH https://api.dronebundle.com/v1/projects/01964c6b-7a3e-7f00-8000-abc123def456/jobs/019d4350-a1b2-7c3d-8e4f-567890abcdef \
  -H "Authorization: Bearer v1_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "priority": "medium",
    "capture_types": ["drone_inspection", "thermal_inspection"]
  }'
{
  "message": "Job updated"
}

Errors

400 Bad Request - Validation failed.
{
  "message": "name must be between 1 and 100 characters"
}
Other validation messages include:
  • status must be one of: draft, not_started, in_progress, ...
  • priority must be one of: low, medium, high
  • start_date must be a valid ISO date string
  • end_date cannot be before start_date
  • latitude must be between -90 and 90
  • Both latitude and longitude must be provided together
  • other_status_reason is required when status is "other"
404 Not Found - Job not found.
{
  "message": "Job not found"
}