---
title: "Persist a worker report for later orchestrator delivery"
method: POST
path: "/api/v1/reports"
tags: ["reports"]
---

# Persist a worker report for later orchestrator delivery

`POST /api/v1/reports`

## Request body

- CreateReportRequest
  - `message` string
  - `note` string
  - `outputs` ReportOutputRequest[]
    - `kind` 'artifact' | 'pr_created' | 'pr_reviewed', required
    - `label` string
    - `reference` string, required
  - `sessionId` string, required
  - `state` 'checkpoint' | 'needs_input' | 'stuck' | 'done'

## Response `201`

Created

- CreateReportResponse
  - `id` string, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error
- `501` — Not Implemented

## Changes

- **2026-09-23** `c9673ebc394b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/reports/post.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/371302977441?raw)