AGENTUTIL
DocsTools Reference

Home Services Request

$0.05per call
homeservices.request

Submit a service request to a specific professional (from homeservices.search results)

Endpoint
POST /v1/tools/homeservices.request/tasks

Input

FieldTypeRequiredDescription
pro_idstringyesProfessional ID from homeservices.search results (e.g. pro_abc123)
requesterobjectyes
notesstringyesJob description — details of what work is needed

Output

FieldTypeDescription
request_idstringUnique ID for this service request
pro_idstringID of the professional notified
pro_namestringName of the professional notified
statusstringAlways 'sent' on success
messagestringHuman-readable confirmation message

Example

Request
{
  "pro_id": "pro_abc123",
  "requester": {
    "name": "John Doe",
    "phone": "415-555-0100"
  },
  "notes": "Leaky faucet in kitchen, needs repair ASAP"
}
Response
{
  "request_id": "req_xk8f2a9c0012",
  "pro_id": "pro_abc123",
  "pro_name": "Bay Area Plumbing",
  "status": "sent",
  "message": "Request sent to Bay Area Plumbing."
}