---
title: "Create Custom Prompt Task"
method: POST
path: "/api/agent-scheduled-tasks/custom-prompt"
tags: ["agent-scheduled-tasks"]
---

# Create Custom Prompt Task

`POST /api/agent-scheduled-tasks/custom-prompt`

Create a new custom prompt scheduled task.

This creates a scheduled task definition with routine_type='custom_prompt'
and stores the user's custom prompt in the agent_scheduled_task_prompts table.

## Query parameters

- `user_id` string
- `org_id` string

## Request body

- CreateCustomPromptTaskRequest — Request body for creating a custom prompt task.
  - `display_name` string, required
  - `schedule_type` string, required
  - `schedule_config` object, required
  - `config` object
  - `prompt` string, required
  - `context_entities` object[], nullable
  - `timezone` 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/f8600f7a4ae3/schema)