---
title: "Run a scheduled task"
method: POST
path: "/automations/v1/{automationId}/run"
tags: ["Scheduled Tasks"]
---

# Run a scheduled task

`POST /automations/v1/{automationId}/run`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/automations/v1/{automationId}/run`
- Auth: HTTP bearer

Enqueues one run and returns immediately. conversationId is null. A paused task can be run, and active stays unchanged.

## Path parameters

- `automationId` string, uuid, required

## Response `200`

Run queued. Body is runId and conversationId null.

## Other responses

- `400`: Invalid task id
- `401`: Invalid or missing API key, or the key user was not found
- `403`: Missing AUTOMATION_API, Scheduled Tasks disabled, no product access, or TRIAL_EXPIRED
- `404`: Message AUTOMATION_NOT_FOUND
- `405`: Method not allowed
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/automations/v1/:automationId/run/post.md)

---

[API](https://skmtc.dev/langdock/apis/langdock-api.md) - [All operations](https://skmtc.dev/langdock/apis/langdock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdock/apis/langdock-api/revisions/c62bf90b4013?raw)