---
title: "Changes to Create or update a report by publicId"
method: PUT
path: "/api/v1/deployments/{deploymentId}/reports/by-public-id/{publicId}"
---

# Changes to Create or update a report by publicId

`PUT /api/v1/deployments/{deploymentId}/reports/by-public-id/{publicId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 11 revisions.

- **2026-09-02** `914d24830bb3` — 3 info
- **2026-08-27** `97e151460143` — 17 info
- **2026-07-31** `a0c6b1d2ac96` — 1 info

## Changes

- **2026-09-02** `914d24830bb3` — 3 info
  - added the optional property `currentQueryChecksum` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/queryChecksum` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/syncStatus` to the response with the `200` status
- **2026-08-27** `97e151460143` — 17 info
  - added the new optional request property `host`
  - added the new optional request property `pivotItems/oneOf[#/components/schemas/PivotItemsInput]/measuresAxis`
  - added the new optional request property `pivotItems/oneOf[#/components/schemas/PivotItemsInput]/measuresPosition`
  - added the new optional request property `sheetId`
  - added the new optional request property `workbookName`
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/anchorCell` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/host` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/id` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/placedAt` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/placedByUserId` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/refreshedAt` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/refreshedByUserId` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/sheetId` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/sheetName` to the response with the `200` status
  - added the optional property `externalWorkbookPlacements/oneOf[subschema #1]/items/workbookName` to the response with the `200` status
  - added the optional property `pivotItems/oneOf[#/components/schemas/PivotItems]/measuresAxis` to the response with the `200` status
  - added the optional property `pivotItems/oneOf[#/components/schemas/PivotItems]/measuresPosition` to the response with the `200` status
- **2026-07-31** `a0c6b1d2ac96` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/cube-js/apis/cube-cloud-rest-api/docs/api/v1/deployments/:deploymentId/reports/by-public-id/:publicId/put.md) · [API](https://skmtc.dev/cube-js/apis/cube-cloud-rest-api.md) · [Page](https://skmtc.dev/cube-js/apis/cube-cloud-rest-api/changes/api/v1/deployments/:deploymentId/reports/by-public-id/:publicId/put)