---
title: "POST /reports/{id}/consultant/runs"
method: POST
path: "/reports/{id}/consultant/runs"
tags: ["Reports"]
---

# POST /reports/{id}/consultant/runs

`POST /reports/{id}/consultant/runs`

## Path parameters

- `id` string, required

## Request body

- ReportConsultantRunRequest
  - `action` 'explain_key_changes' | 'find_data_gaps' | 'draft_executive_summary' | 'recommend_next_actions', required
  - `draftTarget` string
  - `instruction` string

## Response `200`

Completed consultant analysis run

- ReportConsultantRunResponse
  - `data` ReportConsultantRun, required
    - `action` 'explain_key_changes' | 'find_data_gaps' | 'draft_executive_summary' | 'recommend_next_actions', required
    - `cards` ReportConsultantCard[], required
      - `body` string, required
      - `confidence` 'high' | 'medium' | 'low', required
      - `evidenceIds` string[], required
      - `id` string, required
      - `priority` 'high' | 'medium' | 'low'
      - `suggestedDestination` string
      - `title` string, required
      - `type` 'finding' | 'risk' | 'data_gap' | 'assumption' | 'summary' | 'action', required
    - `createdAt` string, date-time, required
    - `createdBy` string
    - `draftTarget` string
    - `id` string, required
    - `instruction` string
    - `reportId` string, required
    - `status` 'completed' | 'failed', required
    - `updatedAt` string, date-time, required
    - `warnings` string[], required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greentally/esgai-api/revisions/4fccdcaa5e57/schema)