Check homeowner approval
check_approvalReturns whether the homeowner accepted or denied a pending approval request. The interval output field is the minimum wait in seconds before the next check (5 to 60 seconds). Each call records a poll time. Polling sooner than interval returns status slow_down, increases interval by 5 seconds up to 60, and restarts the wait from that poll. It cannot approve or send a job. US only. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"approvalId": "<approvalId>"
},
"name": "check_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| approvalId | Yes | The approvalId returned by request_approval or send_job_to_contractors. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| outcome | Yes | Plain machine-readable result for any approval kind: 'approved_and_done' means the homeowner said yes and InstaBids carried out the request; the same word without _and_done means the homeowner said yes but it is not carried out yet (call the asking tool again with this approvalId if it told you to). | |
| interval | Yes | ||
| sentence | Yes | One plain sentence the assistant can relay to the homeowner. |