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

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

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

## Request

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

## Path parameters

- `project_id` integer, required

## Request body

- PutCronJobBody
  - `actor` string
  - `definition` CronJobDefinition, required
    - `action` Action, required
      - `kind` string, required
      - `message` string
      - `prompt` string
      - `recipient` string
      - `workflow_uid` string
    - `catchup` string, required
    - `checkout_key` string
    - `enabled` boolean, required
    - `grace_seconds` integer
    - `issue` IssuePolicy
      - `body` string
      - `deadline_offset_seconds` integer
      - `kind` string, required
      - `parent_uid` string
      - `scheduled_offset_seconds` integer
      - `title` string
      - `uid` string
    - `kind` string, required
    - `options` object
    - `overlap` string, required
    - `secret_refs` object
    - `timeout_seconds` integer
    - `trigger` Trigger, required
      - `at` string
      - `cron` string
      - `interval_seconds` integer
      - `issue_uid` string
      - `kind` string, required
      - `lead_seconds` integer
      - `timezone` string
    - `version` integer, required
  - `expected_event_uid` string
  - `name` string, required

## Response `201`

Created

- CronJobResponseBody
  - `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
  - `job` CronJob, required
    - `author` string, required
    - `created_at` string, date-time, required
    - `definition` CronJobDefinitionResponse, required
      - `action` ActionResponse, required
        - `kind` string, required
        - `message` string
        - `prompt` string
        - `recipient` string
        - `workflow_uid` string
      - `catchup` string, required
      - `checkout_key` string
      - `enabled` boolean, required
      - `grace_seconds` integer
      - `issue` IssuePolicyResponse
        - `body` string
        - `deadline_offset_seconds` integer
        - `kind` string, required
        - `parent_uid` string
        - `scheduled_offset_seconds` integer
        - `title` string
        - `uid` string
      - `kind` string, required
      - `options` object
      - `overlap` string, required
      - `secret_refs` object
      - `timeout_seconds` integer
      - `trigger` TriggerResponse, required
        - `at` string
        - `cron` string
        - `interval_seconds` integer
        - `issue_uid` string
        - `kind` string, required
        - `lead_seconds` integer
        - `timezone` string
      - `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-13** `ccbe1c9457fc`: 2 info
  - added the new optional request property `definition/issue/parent_uid`
  - added the optional property `job/definition/issue/parent_uid` to the response with the `201` status
- **2026-10-10** `47a2f9e572d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/:project_id/cron/jobs/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)