---
title: "Create Definition"
method: POST
path: "/api/agent-scheduled-tasks"
tags: ["agent-scheduled-tasks"]
---

# Create Definition

`POST /api/agent-scheduled-tasks`

Create a new scheduled task definition.

This is a generic endpoint for creating any type of scheduled task.

## Query parameters

- `user_id` string
- `org_id` string

## Request body

- RoutesAgentScheduledTasksCreateDefinitionRequest — Request body for creating a scheduled task definition.
  - `routine_type` string, required
  - `display_name` string, required
  - `schedule_type` string, required
  - `schedule_config` object, required
  - `config` object, required
  - `timezone` string, required
  - `thread_id` string, nullable
  - `email_results` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/9744001af85d/schema)