requests.convert

Turn a request into a job at its property or address and link them both ways. The request's property becomes the job's home, and the job keeps the request. The worker then writes the quote or books a visit.

WhoAgents can call this
RESTPOST /v1/requests/convert
MCP toolrequests_convert
Writesyes, send an Idempotency-Key
AreaCustomer hub, requests and customer emails

When to use it

Turn a request into a job at its property or address and link them both ways. The request's property becomes the job's home, and the job keeps the request.

What to tell the owner

Say what you did in plain words and what happens next.

Input

FieldTypeRequired
request_idstring (uuid)yes
customer_idstring (uuid)no
addressobjectno
address.line1stringyes
address.line2stringno
address.localitystringyes
address.postal_codestringyes
address.jurisdictionstringyes
summarystringno

Example

POST https://doingwork.work/v1/requests/convert
content-type: application/json
Idempotency-Key: 3f1c...

{
  "request_id": "00000000-0000-4000-8000-000000000000"
}

Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.