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.

Note

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.

Tip

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

job_id

•

guid

ID of the UNDER_CONSTRUCTION job to request a Pro for.

Sample Request

Copied
1curl -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

Copied
1{
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}

Last updated on November 27, 2023