Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Output Allowlist

Agents that use url_fetch or web_search can be restricted to specific hostnames:

allowed_hosts = ["api.example.com", "docs.example.com"]
BehaviorDetail
Empty or absentAll public hostnames allowed
Non-empty listOnly exact hostname matches permitted (case-insensitive, no wildcard subdomains)
Private IPsAlways blocked regardless of allowlist — loopback, link-local, RFC 1918, CGNAT, IPv6 private
RedirectsEach redirect destination is re-validated against the allowlist and private IP check
Sub-agentsInherit the parent’s allowed_hosts unless the sub-agent TOML explicitly sets its own