# 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

```bash
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

```json
{
  "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
}
```

---
Source: https://browsable-api-ux-staging.pages.dev/docs/api/tasks/execute