# 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

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

## Response

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

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