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 pages and executable actions for an intent

/v1/findPOST
Pages come from configured search providers; actions from the registry. One ranking: relevance times reliability, with an explanation per result. Action search works with no provider configured.
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
intent *string
Min length: 1Max length: 2000
domains?string[]
Max items: 20
maxRisk?"read" | "write" | "sensitive" | "irreversible" | "financial"
auth?"none" | "session" | "oauth"
minReliability?number
Min: 0Max: 1
pages?"none" | integer
Default: 5
actions?integer
Default: 5Min: 0Max: 20
Response
200 · Success
pages *object[]
Show item properties
url *string (uri)
title *string
snippet *string
provider *string
score *number
explanation *object
Show properties
relevance *number
reliability *numbernull
score *number
reasons *string[]
Max items: 8
actions *object[]
Show item properties
domain *string
Pattern: ^(?=.{1,253}$)([a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$
actionId *string
Pattern: ^[a-z][a-z0-9_.-]{1,63}$
name *string
description *string
inputSummary *object[]
Show item properties
name *string
type *string
required *boolean
risk *"read" | "write" | "sensitive" | "irreversible" | "financial"
auth *"none" | "session" | "oauth"
reliability *number | null
recipeStatus *"candidate" | "verified" | "degraded" | "quarantined" | "revoked" | null
policy *"allow" | "deny" | "require_approval"
score *number
explanation *object
Show properties
relevance *number
reliability *numbernull
score *number
reasons *string[]
Max items: 8
timings *object
Show properties
totalMs *number
cached *boolean
warnings *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/find" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "intent": "string", "domains": [ "string" ], "maxRisk": "read", "auth": "none", "minReliability": 0, "pages": 5, "actions": 5 }'