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.

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

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

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' \
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

requested_provider_id

•

guid

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

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