vault

Fetch one URL into the vault

Queues a durable fetch. Poll GET /v1/jobs/{job_id}. Direct, OA and Browser rungs are free; a URL reaching Firecrawl costs 2 cents. Provider and rung_max may only narrow the saved workspace policy. Idempotency-Key prevents duplicate admission.

post/v1/vault/fetch

Request

  • Base URL: https://api.hyperresearch.ai
  • URL: https://api.hyperresearch.ai/v1/vault/fetch
  • Auth: one of:
    • HTTP bearer
    • API key in cookie hr_session

Request body

urlstring uri required
tagsstring[]
rung_max'L0' | 'L1' | 'L2' | 'L3' | 'L4'
provider'direct' | 'oa' | 'browser-run' | 'firecrawl' | 'firecrawl-stealth'

Response

Fetch job

job_idstring required
kind'fetch' required
status'queued' | 'running' | 'done' | 'failed' required
poll_urlstring required

Changes

No recorded changes to this operation across all 1 revision of this API.