---
title: "Update"
method: POST
path: "/api/v1/reporting/reports/{id}"
tags: ["Report"]
---

# Update

`POST /api/v1/reporting/reports/{id}`

Invokes the c1.api.reporting.v1.ReportingService.Update method.

## Path parameters

- `id` string, required — The id field.

## Request body

- C1ApiReportingV1ReportingServiceUpdateRequestInput — Both editable fields are optional; an empty one leaves the stored value alone. At least one must be set.
  - `displayName` string — The displayName field.
  - `parameterValues` object, nullable
  - `prompt` string — Editing this does not re-plan, so it may drift from program.planned_from_prompt — that drift is how a stale report is detected.

## Response `200`

Successful response

- C1ApiReportingV1ReportingServiceUpdateResponse — The ReportingServiceUpdateResponse message.
  - `report` C1ApiReportingV1Report — Report is a saved report: the question, the program that answers it, and the parameters a re-run may vary.
    - `createdAt` string, date-time, nullable
    - `createdByUserId` string — The createdByUserId field.
    - `deletedAt` string, date-time, nullable
    - `displayName` string — The displayName field.
    - `id` string — The id field.
    - `latestRunId` string — Separate pointers: the last attempt may have failed while callers still need the last renderable result.
    - `latestSuccessfulRunId` string — The latestSuccessfulRunId field.
    - `parameterSchema` object, nullable
    - `parameterValues` object, nullable
    - `program` C1ApiReportingV1ProgramRef — ProgramRef points at a pinned, executable program.
      - `commitId` string — Code mode invokes by explicit commit, so the commit — not the function — is what a refresh re-executes.
      - `functionId` string — A saved report owns its Function, so this is per-report rather than the shared code-mode scratch function the program first ran on.
      - `plannedFromPrompt` string — The prompt this program was planned from. Report.prompt is editable and a refresh never re-plans, so this is the only way to detect that a report's question has drifted from the program answering it.
    - `prompt` string — The editable natural-language question. Only a re-plan reads this.
    - `tenantId` string — The tenantId field.
    - `updatedAt` string, date-time, nullable

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)