Execute Task API

Execute any task by its canonical task key. Prebuilt tasks may also expose a friendly alias route such as /v1/reddit/search.

POST /v1/tasks/{task_key}/runs

Async vs Sync

Set _run.async to false for synchronous execution (waits up to 25 seconds).

Example

curl -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/tasks/reddit-search/runs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "openai", "_run": { "async": false }}'

Response

{
  "run_id": "00000000-0000-4000-8000-000000000001",
  "task_key": "reddit-search",
  "task_name": "Reddit Search",
  "run_status": "succeeded",
  "status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
  "result": {
    "count": 10,
    "results": []
  },
  "error": null
}