---
title: "POST /api/v1/projects/{project_id}/cron/workflows"
method: POST
path: "/api/v1/projects/{project_id}/cron/workflows"
---

# POST /api/v1/projects/{project_id}/cron/workflows

`POST /api/v1/projects/{project_id}/cron/workflows`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `project_id` integer, required

## Request body

- PutCronWorkflowBody
  - `actor` string
  - `definition` CronWorkflowDefinition, required
    - `about` string
    - `input` string
    - `options` object
    - `steps` CronWorkflowStep[], required
      - `after` string[]
      - `command` string
      - `key` string, required
      - `kind` string, required
      - `options` object
      - `prompt` string
      - `retries` integer
    - `version` integer, required
  - `expected_event_uid` string
  - `name` string, required

## Response `201`

Created

- CronWorkflowResponseBody
  - `events` Event[]
    - `actor` string, required
    - `content_hash` string, required
    - `created_at` string, date-time, required
    - `hlc_counter` integer, required
    - `hlc_physical_ms` integer, required
    - `id` integer, required
    - `issue_id` integer
    - `issue_short_id` string
    - `issue_uid` string
    - `origin_instance_uid` string, required
    - `payload` string, required
    - `project_id` integer, required
    - `project_name` string, required
    - `project_uid` string, required
    - `related_issue_id` integer
    - `related_issue_short_id` string
    - `related_issue_uid` string
    - `type` string, required
    - `uid` string, required
  - `workflow` CronWorkflow, required
    - `author` string, required
    - `created_at` string, date-time, required
    - `definition` CronWorkflowDefinitionResponse, required
      - `about` string
      - `input` string
      - `options` object
      - `steps` CronWorkflowStepResponse[], required
        - `after` string[]
        - `command` string
        - `key` string, required
        - `kind` string, required
        - `options` object
        - `prompt` string
        - `retries` integer
      - `version` integer, required
    - `definition_event_uid` string, required
    - `definition_hlc` HLC, required
      - `counter` integer, required
      - `origin_instance_uid` string, required
      - `physical_ms` integer, required
      - `version` integer, required
    - `deleted_at` string, date-time
    - `id` integer, required
    - `name` string, required
    - `project_id` integer, required
    - `revision` integer, required
    - `uid` string, required
    - `updated_at` string, date-time, required

## Other responses

- `default`: Error

## Changes

- **2026-10-10** `47a2f9e572d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/:project_id/cron/workflows/post.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) - [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) - [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/351807923500?raw)