---
title: "Run task"
method: POST
path: "/task-runs"
tags: ["Workflow Tasks (Beta)"]
---

# Run task

`POST /task-runs`

Kicks off a run of the workflow task with the provided ID, passing the provided input data.

## Request body

- object
  - `task` string, required — A task slug in the format workflow-slug/task-name. An optional version can be appended (workflow-slug/task-name:version). If no version is provided, the latest version is used.
  - `input` union, required — Input data for a task. Can be either an array (for positional arguments) or an object (for named parameters).
    - unknown[] — Positional arguments passed to the task function
      - unknown
    - object — Named parameters passed to the task function as keyword arguments

## Response `202`

Task run created

- TaskRun — unresolved $ref

## Other responses

- `400` — The request could not be understood by the server.
- `401` — Authorization information is missing or invalid.
- `403` — You do not have permissions for the requested resource.
- `404` — Unable to find the requested resource.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

[API](https://skmtc.dev/render/apis/render-public-api.md) · [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/render/render-public-api/revisions/80e0ff74d033/schema)