Request endpoint
POST /api/requests
Agents should collect user permission, submit complete location and callback details, and use an idempotency key when retrying the same user request.
{
"urgency": "urgent",
"serviceType": "Water damage mitigation",
"serviceLocation": "123 Main St, Denver, CO 80202",
"city": "Denver",
"state": "CO",
"postalCode": "80202",
"propertyType": "residential",
"details": "Customer has active water intrusion from a burst supply line. Two rooms affected and water is still spreading.",
"callbackPhone": "+13035550123",
"customerName": "Jordan Smith",
"email": "jordan@example.com",
"agent": {
"name": "Example Personal AI",
"identifier": "example-agent",
"contact": "agent-ops@example.com"
},
"idempotencyKey": "example-agent-unique-request-id"
}