Workflows
Assign next available engineer
Find a rostered engineer with no assignment overlapping the job's scheduled window, preferring the lightest workload, and assign the job to them. An unscheduled job has no window to clash with, so the whole roster is considered. Skills and travel are not taken into account. Answers 409 with E_AP_4005 when the job already has an assignment and 409 with E_AP_4006 when nobody on the roster is free for its window; 404 means the job itself was not found.
post/v1/workflows/assign-next-available-engineer
Request
- Base URL: https://api.workwing.io
- URL: https://api.workwing.io/v1/workflows/assign-next-available-engineer
- Auth: HTTP bearer
Headers
Idempotency-Keystring required
Unique per write, 1-256 printable ASCII characters. Retrying with the same key and the same request replays the original response for 24 hours. See Idempotency.
Request body
Response
Default Response
Changes
No recorded changes to this operation across all 1 revision of this API.