Assign a crew to a work order

Assigns a crew to a work order, checking the crew's capacity first. Pass work_order_id and crew_id at the top level of the body. This is the API behind a dispatch board: use it to clear work orders that still need a crew.

  • The crew must be active and work with the company; otherwise the request returns 404.
  • The assignment is refused with 422 if the crew is already at or over its weekly capacity this week, or if it is already booked on overlapping dates.
  • On success the crew is notified of the new assignment.
  • The token's role must be able to view all company records or have the Work production jobs permission, or the token's user must have created the work order. The token needs the write scope.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
string
required
Responses
200

The crew was assigned; the response is the updated work order.

422

The crew could not take the work order; error explains why.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here!