---
title: "Update Research"
method: PUT
path: "/v1/research/{id}"
tags: ["Research"]
---

# Update Research

`PUT /v1/research/{id}`

Update a research report (title, content, schedule, public visibility).

## Path parameters

- `id` string, required

## Headers

- `authorization` string, nullable

## Request body

- ResearchUpdateRequest — Schema for updating a research report.
  - `title` string, nullable — Update title
  - `content` union — Updated content (JSON for dashboards, markdown for reports)
    - string
    - object
  - `cadence_minutes` integer, nullable — Schedule cadence in minutes (min 60, or 0 to disable)
  - `schedule_status` 'active' | 'paused', nullable — Schedule status
  - `next_execution_at` string, nullable — Next scheduled execution time (ISO 8601 format)
  - `public` boolean, nullable — Whether the research is publicly accessible

## Response `200`

Successful Response

- ResearchReport — Schema for a research report.
  - `id` string, required — Report ID
  - `type` string — Artifact type (report or dashboard)
  - `title` string, required — Report title
  - `content` union — Report content - markdown for reports, JSON for dashboards (includes layout)
    - string
    - object
  - `status` string, required — Report status
  - `query` string, required — Research query
  - `created_at` string, required — Creation timestamp
  - `updated_at` string, nullable — Update timestamp
  - `knowledge_slug` string, nullable — Knowledge base slug
  - `organization_slug` string, required — Organization slug
  - `cadence_minutes` integer, nullable — Schedule cadence in minutes
  - `next_execution_at` string, nullable — Next scheduled execution time
  - `last_executed_at` string, nullable — Last scheduled execution time
  - `schedule_status` string, nullable — Schedule status: active, paused, or null
  - `public` boolean, nullable — Whether the research is publicly accessible

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chonkie/apis/chonkie-api.md) · [All operations](https://skmtc.dev/chonkie/apis/chonkie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chonkie/apis/chonkie-api/revisions/f40f036f941c?raw)