Request a previous Pro
Request a Pro that the client has worked with before (subject to availability).
If you would like to work with one of your previous Pros, you can request them without knowing their ID.
The system will choose from one of the Pros from prior jobs and update the requested_provider
property accordingly.
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.
Have a specific Pro in mind? Use the Request a Pro endpoint.
Endpoint
Method | Url |
---|---|
POST | v1.0/jobs/{job_id}/requested-provider/request-previous |
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/request-previous' \2-H 'Authorization: Bearer {token}'
Request Payload
This endpoint does not accept a request payload.
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}