---
title: "Create a scheduled task"
method: POST
path: "/automations/v1"
tags: ["Scheduled Tasks"]
---

# Create a scheduled task

`POST /automations/v1`

## Request

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

Creates a scheduled task owned by this key's member or service account. New tasks start active. The response does not include runCount.

## Request body

- object
  - `name` string, required
  - `prompt` string, required
  - `frequency` 'MANUAL' | 'DAILY' | 'WEEKDAYS' | 'WEEKLY' | 'MONTHLY' | 'SELECTED_WEEKDAYS', required
  - `timeOfDay` string, nullable: 24 hour HH:mm. Required unless frequency is MANUAL.
  - `dayOfWeek` integer, nullable: Required for WEEKLY. 0 is Sunday and 6 is Saturday.
  - `dayOfMonth` integer, nullable: Required for MONTHLY.
  - `daysOfWeek` integer[]: Required for SELECTED_WEEKDAYS.
  - `timezone` string, nullable: IANA timezone. Empty or omitted on a scheduled frequency is stored as UTC.
  - `modelMode` 'UNSET' | 'EXPLICIT' | 'AUTO'
  - `modelId` string, uuid, nullable: Required in the same request when modelMode is EXPLICIT.
  - `assistantId` string, uuid, nullable
  - `taggedAssistantId` string, uuid, nullable
  - `taggedIntegrationIds` string[]
  - `taggedKnowledgeFolderIds` string[]
  - `taggedWorkflowIds` string[]
  - `taggedSkillSlugs` string[]
  - `attachmentIds` string[]

## Response `201`

Scheduled task created. The automation object does not include runCount.

## Other responses

- `400`: Invalid body, or message AUTOMATION_LIMIT_REACHED
- `401`: Invalid or missing API key, or the key user was not found
- `403`: Missing AUTOMATION_API, Scheduled Tasks disabled, no product access, TRIAL_EXPIRED, or AUTOMATION_TAG_ACCESS_DENIED
- `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/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)