List Tasks API

Discover the tasks available to your team, including prebuilt tasks and your own generated tasks.

GET /v1/tasks

This is the main discovery endpoint for humans, generated clients, and LLM-based tooling. It includes the user-facing metadata you need to discover and choose tasks: friendly alias routes, canonical endpoints, parameter summaries, auth requirements, docs URLs, and pricing metadata. For the full machine-readable contract, fetch a single task with GET /v1/tasks/{task_key}.

Query Parameters

limit controls page size.
cursor continues from a previous page.
type filters tasks to custom or prebuilt.

By default, your own custom tasks are returned first, followed by prebuilt tasks.

Example

curl -X GET "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/tasks?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "tasks": [
    {
      "task_key": "reddit-search",
      "task_type": "prebuilt",
      "name": "Reddit Search",
      "description": "Search Reddit posts by query and return structured post data.",
      "method": "POST",
      "alias_endpoint": "/v1/reddit/search",
      "canonical_endpoint": "/v1/tasks/reddit-search/runs",
      "docs_url": "/docs/api/endpoints/post-reddit-search",
      "credit_cost": 5,
      "request_parameters": [
        {
          "key": "query",
          "type": "string",
          "required": true,
          "description": "Search query",
          "location": "body",
          "sample": "artificial intelligence"
        }
      ],
      "auth_requirements": null
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "previous_cursor": null
  }
}

Use GET /v1/tasks/{task_key} when you need the full metadata for a single task. Custom tasks may return null for alias_endpoint and docs_url when they do not have a public-friendly alias or docs page.