Update Job

Update an existing job within a project.

cURL

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"]
  }'

200

{
  "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

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"]
  }'

200

{
  "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"
}