Web Tasks

Start a research task

Answers a question by reading public pages, with sources, progress and cost. With an API key, HTTP reserves credits and settles actual cost. Without a key, x402 pays a fixed execution budget in limits.max_cost_usd. MCP start requires an API key and reserves credits, settling actual cost. With an API key, use the owning key for free status/cancel and send Idempotency-Key (required, maximum 100 characters). The x402 response returns access_token: send it as Task-Token for status/cancel. For x402 retries send the same Task-Token and Idempotency-Key (maximum 200 characters). A 202 confirms acceptance, not a completed result.

post/tasks/v1/research

Request

  • Base URL: https://api.oassis.dev
  • URL: https://api.oassis.dev/tasks/v1/research
  • Auth: one of:
    • HTTP bearer
    • none

Headers

Idempotency-Keystring

Required for API-key starts (1-100 characters). Optional for x402 starts (1-200 characters); reuse it with the same Task-Token and body to retry. Conflicting payloads return 409.

Request body

taskstring required

What to find out, in plain words. Be specific about what to compare.

mode'research'

Only research is available: read public pages and answer.

urlsstring[]

Pages to read first, up to 5. Public http or https urls only.

Response

Accepted, not completed. Location points at the task. Body includes task_id, status and location; x402 also returns access_token. Poll status until a terminal outcome.

Changes

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