hub.requestVisitChange

From the customer hub, ask the shop to move (reschedule, with the times that work better) or cancel an upcoming visit. The visit stays as it is until the shop answers. One open request per visit. Hosted page only.

WhoHosted page only (a person does it in the browser)
RESTPOST /v1/hub/requestVisitChange
MCP toolNot an MCP tool
Writesyes, send an Idempotency-Key
AreaCustomer hub, requests and customer emails

When to use it

From the customer hub, ask the shop to move (reschedule, with the times that work better) or cancel an upcoming visit. The visit stays as it is until the shop answers.

What to tell the owner

Send the person the link. They finish this step themselves on the page; you never do it for them.

Input

FieldTypeRequired
kstringyes
visit_idstring (uuid)yes
kindstring (one of reschedule, cancel)yes
preferred_timesstringno
notestringno

Example

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

{
  "k": "...",
  "visit_id": "00000000-0000-4000-8000-000000000000",
  "kind": "reschedule"
}

Output

FieldTypeAlways there
change_request_idstring (uuid)yes
statusstringyes
{
  "change_request_id": "00000000-0000-4000-8000-000000000000",
  "status": "..."
}

Errors

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