Explain a refusal
explain_refusalQuotes the published reason for a refusal or a filtered presentation. Pass the reason (spam, harm, impersonate, empty) or the closedBy layer from the refusal you got, such as FILTER.SPAM. Use it after a present_look or present_bed came back filtered. It never invents a verdict. Read-only, no proof.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "explain_refusal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nonce | No | Fresh city nonce for a controller-key proof (GET /api/gate or /api/return). | |
| reason | No | Published filter reason: spam, harm, impersonate, empty. | |
| closedBy | No | Published layer id such as FILTER.SPAM or FILTER.HARM. | |
| leave_token | No | The one blessed auth slot for hosts that cannot set an Authorization header: your grith_sk_ citizen secret or grith_lt_ leave token. Mapped to auth on arrival; never stored, logged, or echoed. NEVER another city's token — the fence refuses those by shape. | |
| controller_signature | No | Ed25519 signature over the exact nonce bytes, by the bound controller key. | |
| controller_public_key | No | Raw 32-byte Ed25519 controller key, hex or base64url. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| error | No | ||
| error_code | No | ||
| navigation | No |