# Platform API for Tasks

> Find a task, price it, run it, and read what you spent.

Find a task, price it, run it, and read what you spent.

## Available operations

- [List tasks](https://docs.refabric.com/api-reference/platform/tasks/list-tasks) — `GET /v1/tasks`: Every task you can run, each with its `inputSchema` and `outputSchema`.
- [Read a task](https://docs.refabric.com/api-reference/platform/tasks/read-a-task) — `GET /v1/tasks/{name}`: One task, exactly as `GET /v1/tasks` lists it.
- [Run a task](https://docs.refabric.com/api-reference/platform/tasks/run-a-task) — `POST /v1/tasks/{name}`: `202` with the new job's `job_id` and its status, result and cancel URLs — or, while waiting, the job's result itself.
- [Read prices](https://docs.refabric.com/api-reference/platform/tasks/read-prices) — `GET /v1/pricing`: Every task's prices, per option, read live from the price list — the same figures `POST /v1/tasks/{name}/estimate` answers for each option.
- [Estimate a task](https://docs.refabric.com/api-reference/platform/tasks/estimate-a-task) — `POST /v1/tasks/{name}/estimate`: What this request would cost — a ceiling: the job, when run, is charged for what it delivers, never more.
- [Read your usage](https://docs.refabric.com/api-reference/platform/tasks/read-your-usage) — `GET /v1/account/usage`: Your spend in `[start, end)` — the whole account, every key and the app: one row per task, API key and credit type, with job counts and the credits charged.
- [Read your metrics](https://docs.refabric.com/api-reference/platform/tasks/read-your-metrics) — `GET /v1/account/metrics`: Your jobs and calls in `[start, end)`, one row per group — the whole account: job counts and outcomes, queue and run time percentiles, credits charged and the calls your API keys made.
- [List your requests](https://docs.refabric.com/api-reference/platform/tasks/list-your-requests) — `GET /v1/account/requests`: The calls your API keys made in `[start, end)`, newest first.
- [List task examples](https://docs.refabric.com/api-reference/platform/tasks/list-task-examples) — `GET /v1/tasks/{name}/examples`: A task's examples in their shown order: the request that was sent and the files it sent and delivered.
- [Read a task's OpenAPI document](https://docs.refabric.com/api-reference/platform/tasks/read-a-tasks-openapi-document) — `GET /v1/tasks/{name}/openapi.json`: One task's own OpenAPI document: running it, estimating it, its examples and its job and result reads, with the task's input and output as named schemas.
- [Read the task index for language models](https://docs.refabric.com/api-reference/platform/tasks/read-the-task-index-for-language-models) — `GET /v1/tasks/llms.txt`: Every task as plain text for language models, one line each, grouped by category: its name, what it does and a link to its page.
- [Read a task's page for language models](https://docs.refabric.com/api-reference/platform/tasks/read-a-tasks-page-for-language-models) — `GET /v1/tasks/{name}/llms.txt`: One task's page as plain text for language models: its inputs, examples, output, errors and limits.