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 for them to work on the job 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, the system reverts to choosing the first available Pro upon 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": "The name of the job",
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 April 16, 2025