Assign Pilots

Assign one or more pilots to a job.

cURL

curl -X POST https://api.dronebundle.com/v1/projects/01964c6b-7a3e-7f00-8000-abc123def456/jobs/019d4350-a1b2-7c3d-8e4f-567890abcdef/assign \
  -H "Authorization: Bearer v1_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "pilots": ["03144892-6021-705a-08f2-8e147cff3f28"]
  }'

200

{
  "message": "Pilots assigned successfully",
  "results": {
    "successful": 5,
    "skipped": 0,
    "failed": 0
  },
  "pilots_assigned": ["03144892-6021-705a-08f2-8e147cff3f28"],
  "pilots_skipped": [],
  "occurrences_per_pilot": 5
}

Requires an API key with full_access scope.

Assigns pilots to all occurrences of a job. You can get pilot IDs from the List Team Members endpoint using ?role=pilot.

Path parameters

projectId · string · required

The unique identifier of the project.

jobId · string · required

The unique identifier of the job.

Body

pilots · string[] · required

Array of user IDs to assign. Must contain at least one pilot ID.

Response

message · string

Result message.

results · object

Assignment counts.

Show properties

successful · number

Number of successful assignments.

skipped · number

Number of assignments that already existed.

failed · number

Number of failed assignments.

pilots_assigned · string[]

IDs of pilots that were successfully assigned.

pilots_skipped · string[]

IDs of pilots that were already assigned.

occurrences_per_pilot · number

Number of occurrences each pilot was assigned to.

cURL

curl -X POST https://api.dronebundle.com/v1/projects/01964c6b-7a3e-7f00-8000-abc123def456/jobs/019d4350-a1b2-7c3d-8e4f-567890abcdef/assign \
  -H "Authorization: Bearer v1_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "pilots": ["03144892-6021-705a-08f2-8e147cff3f28"]
  }'

200

{
  "message": "Pilots assigned successfully",
  "results": {
    "successful": 5,
    "skipped": 0,
    "failed": 0
  },
  "pilots_assigned": ["03144892-6021-705a-08f2-8e147cff3f28"],
  "pilots_skipped": [],
  "occurrences_per_pilot": 5
}

Errors

400 Bad Request - Invalid request.

{
  "message": "pilots array is required and must not be empty"
}

404 Not Found - Job or pilots not found.

{
  "message": "One or more pilots not found"
}