preflight
Read-onlyIdempotent
Call BEFORE reading, citing, connecting to or transacting with a domain. Returns a signed decision: allow, warn, require_confirmation, block or unsupported, with every step that led there and the resolve answer it was made from. Pass your crawler token as agent so robots.txt is checked for you. A policy can only make the decision stricter. Do not proceed on block; ask the user on require_confirmation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | Your crawler user-agent token, e.g. GPTBot | |
| action | No | What you are about to do (default read) | |
| domain | Yes | Bare domain, e.g. example.com | |
| policy | No | max_age_hours, on_warn (warn|require_confirmation|block), require_entity, human_approval[], allow[], deny[] | |
| template | No | safe_citation, safe_data_retrieval, safe_api_connect, safe_mcp_tool, safe_commerce, safe_oauth or support_escalation |