---
title: "PUT /api/v1/projects/{project_id}/cron/runs/{run_uid}"
method: PUT
path: "/api/v1/projects/{project_id}/cron/runs/{run_uid}"
---

# PUT /api/v1/projects/{project_id}/cron/runs/{run_uid}

`PUT /api/v1/projects/{project_id}/cron/runs/{run_uid}`

## Request

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

## Path parameters

- `project_id` integer, required
- `run_uid` string, required

## Request body

- ObserveCronRunBody
  - `actor` string
  - `definition_event_uid` string
  - `ended_at` string, date-time
  - `executor_label` string
  - `expected_revision` integer, required
  - `issue_uid` string
  - `job_uid` string
  - `occurrence_key` string
  - `started_at` string, date-time
  - `status` 'running' | 'succeeded' | 'failed' | 'cancelled' | 'unknown', required
  - `summary` Summary, required
    - `input_tokens` integer
    - `message` string
    - `output_tokens` integer
    - `version` integer, required
  - `teammate` string, nullable
  - `workflow_definition_event_uid` string
  - `workflow_uid` string

## Response `200`

OK

- ObserveCronRunResponseBody
  - `events` Event[], required
    - `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
  - `replayed` boolean, required
  - `run` CronRun, required
    - `actor` string, required
    - `created_at` string, date-time, required
    - `definition_event_uid` string
    - `ended_at` string, date-time
    - `executor_label` string
    - `id` integer, required
    - `issue_uid` string
    - `job_uid` string
    - `occurrence_key` string
    - `project_id` integer, required
    - `revision` integer, required
    - `started_at` string, date-time
    - `status` string, required
    - `summary` SummaryResponse, required
      - `input_tokens` integer
      - `message` string
      - `output_tokens` integer
      - `version` integer, required
    - `teammate` string
    - `uid` string, required
    - `updated_at` string, date-time, required
    - `workflow_definition_event_uid` string
    - `workflow_uid` string

## 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/runs/:run_uid/put.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)