---
title: "Run a task now"
method: POST
path: "/tasks/{id}/run"
tags: ["Platform"]
---

# Run a task now

`POST /tasks/{id}/run`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/tasks/{id}/run`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Runs once, immediately, without touching the schedule — the way to
confirm a task does what was meant instead of waiting an hour to find
out it does not.

## Path parameters

- `id` string, required

## Response `202`

Run queued

## Other responses

- `409`: The app is not running, or this task is already running

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)