Request a Pro
Request a specific Pro to work on the job (subject to availability).
If you would like to work with a specific Pro, you can request them to work on the while the job is UNDER_CONSTRUCTION
.
The specified user ID must belong to a Pro who is a member of your workspace. If null
is specified, reverts to choosing the first available Pro on submission.
Even if the request succeeds and the job's requested_provider
property is updated, there is no guarantee that the requested
Pro will be available to work on the job. If the requested Pro is not available, the job will be assigned to the first available Pro when the job is submitted.
Want to work with a previous Pro but don't have their user ID handy? Use the Request a Previous Pro endpoint.
Endpoint
Method | Url |
---|---|
POST | v1.0/jobs/{job_id}/requested-provider |
Url Parameters
ID of the UNDER_CONSTRUCTION
job to request a Pro for.
Sample Request
Copied1curl -X POST 'https://api.worklayer.com/v1.0/jobs/499d692d-67aa-4127-a45c-b9e27f54afad/requested-provider' \2-H 'Authorization: Bearer {token}' \3-H 'Content-Type: application/json' \4-d '{5 "requested_provider_id": "4fec291a-fbb8-413a-86c0-f25f51c57ddc"6}'
Request Payload
ID of the requested Pro. If null
, the default behavior of choosing the first available Pro when the job is submitted will be used.
Response
A job belonging to your workspace. See the job reference page
Sample Response
Copied1{2 "id": "499d692d-67aa-4127-a45c-b9e27f54afad",3 "short_id": "TWQXJWMABW8",4 "name": "Name from service package",5 "description": "Tony Stark | 2021 | 1040",6 "status": "UNDER_CONSTRUCTION",7 "create_time": "2021-04-28T13:45:25.781Z",8 "update_time": "2021-04-28T13:52:27.379Z",9 "total_amount": 10,10 "requested_provider": {11 "user_id": "4fec291a-fbb8-413a-86c0-f25f51c57ddc"12 },13 "members": [14 {15 "role": "CHAMPION",16 "type": "CLIENT",17 "user_id": "a4feef24-00da-4340-8b7c-a532e0607fdd",18 "given_name": "Tony",19 "family_name": "Stark",20 "display_name": "Tony Stark"21 }22 ]23}