---
title: "Submit an evidence-linked Research Study finding or report."
method: POST
path: "/api/v1/research-studies/{studyId}"
tags: ["Research Studies"]
---

# Submit an evidence-linked Research Study finding or report.

`POST /api/v1/research-studies/{studyId}`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/research-studies/{studyId}`
- Auth: HTTP bearer

Supports action=submit_finding and action=upsert_report. Requires commentary.research.write, the research.studies.agent_api feature, and study external-agent settings that allow findings or reports. Suggested issue text is stored and exported only; this endpoint does not create GitHub issues.

## Path parameters

- `studyId` string, required

## Headers

- `X-Commentary-Workspace-Id` string
- `X-Correlation-Id` string

## Request body

- object
  - `action` 'submit_finding' | 'upsert_report', required
  - `title` string
  - `summary` string
  - `severity` string
  - `confidence` string
  - `markdown` string
  - `sections` object
  - `evidenceReferences` object[]

## Response `200`

Successful response.

- object

## Other responses

- `400`: The request was invalid.
- `401`: Authentication is required.
- `403`: The token or session does not have permission for this resource.
- `404`: The resource was not found.
- `429`: The request was rate limited.

---

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