Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Find read actions on a site from one public page

/v1/explorePOST
Fetches a handful of pages (robots.txt first, identified as orsel-bot), proposes read actions (read a page, search the site) and keeps only those that run on the fetched pages. Kept actions are signed candidates that only this organization can run until canaries verify them. Refused for sites with a verified owner, which publish their own manifest.
Authorization
bearer *Bearer <token>
API key of the form orsel_<id>.<secret>, sent as Authorization: Bearer. Scopes: find, read, act:read, act:write, act:sensitive, admin. Clients read it from ORSEL_KEY.
Request Bodyapplication/jsonrequired
url *string (uri)
Max length: 2048
Response
200 · Success
domain *string
Pattern: ^(?=.{1,253}$)([a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$
pagesFetched *integer
Min: -9007199254740991Max: 9007199254740991
actions *object[]
Show item properties
actionId *string
Pattern: ^[a-z][a-z0-9_.-]{1,63}$
name *string
inputs *string[]
kind *"read_page" | "list" | "search" | "sign_in" | "sign_up" | "contact" | "subscribe" | "form" | "api"
risk *"read" | "write" | "sensitive" | "irreversible" | "financial"
secrets *string[]
ran *boolean
route *string
outputs *string[]
example *object
recipeHash *string
Pattern: ^[0-9a-f]{64}$
status *"candidate"
rejected *object[]
Show item properties
id *string
reason *string
400 · Invalid request
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "policy_denied" | "approval_required" | "payment_required" | "needs_human" | "internal"
message *string
requestId *string
details?object
401 · Missing, malformed, revoked or expired key
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "policy_denied" | "approval_required" | "payment_required" | "needs_human" | "internal"
message *string
requestId *string
details?object
403 · The key lacks the required scope
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "policy_denied" | "approval_required" | "payment_required" | "needs_human" | "internal"
message *string
requestId *string
details?object
429 · Rate limited. See Retry-After
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "policy_denied" | "approval_required" | "payment_required" | "needs_human" | "internal"
message *string
requestId *string
details?object
Request example
curl -X POST "/v1/explore" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com" }'