For AI agents: this page is also available as Markdown at https://docs.refabric.com/api-reference/platform/tasks.md, and the index of every page is https://docs.refabric.com/llms.txt.
Platform API
Platform API for Tasks
Find a task, price it, run it, and read what you spent.
Available operations
List tasks
GET
/v1/tasksEvery task you can run, each with its inputSchema and outputSchema.Read a task
GET
/v1/tasks/{name}One task, exactly as GET /v1/tasks lists it.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
GET
/v1/pricingEvery 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
POST
/v1/tasks/{name}/estimateWhat this request would cost — a ceiling: the job, when run, is charged for what it delivers, never more.Read your usage
GET
/v1/account/usageYour 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
GET
/v1/account/metricsYour 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
GET
/v1/account/requestsThe calls your API keys made in [start, end), newest first.List task examples
GET
/v1/tasks/{name}/examplesA 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
GET
/v1/tasks/{name}/openapi.jsonOne 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
GET
/v1/tasks/llms.txtEvery 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
GET
/v1/tasks/{name}/llms.txtOne task's page as plain text for language models: its inputs, examples, output, errors and limits.| Operation | Scope |
|---|---|
| List tasks | No key needed. |
| Read a task | No key needed. |
| Run a task | tasks:run |
| Read prices | — |
| Estimate a task | tasks:read |
| Read your usage | account:read |
| Read your metrics | account:read |
| List your requests | account:read |
| List task examples | No key needed. |
| Read a task's OpenAPI document | No key needed. |
| Read the task index for language models | No key needed. |
| Read a task's page for language models | No key needed. |