---
title: "Update a report."
method: PUT
path: "/reports/{id}"
tags: ["reports", "enterprise"]
---

# Update a report.

`PUT /reports/{id}`

Available to org admins only and with a valid or expired license.

You need to have a permission with action `reports.admin:write` with scope `reports:id:<report ID>`.

## Path parameters

- `id` integer, required

## Request body

- CreateOrUpdateConfigCmd
  - `dashboardId` integer
  - `dashboardUid` string
  - `dashboards` DashboardDTO[]
    - `dashboard` DashboardReportDTO
      - `id` integer
      - `name` string
      - `uid` string
    - `reportVariables` object
    - `timeRange` TimeRangeDTO
      - `from` string
      - `to` string
  - `enableCsv` boolean
  - `enableDashboardUrl` boolean
  - `formats` Type[]
  - `message` string
  - `name` string
  - `options` ReportOptionsDTO
    - `layout` string
    - `orientation` string
    - `timeRange` TimeRangeDTO
      - `from` string
      - `to` string
  - `recipients` string
  - `replyTo` string
  - `scaleFactor` integer
  - `schedule` ScheduleDTO
    - `day` string
    - `dayOfMonth` string
    - `endDate` string, date-time
    - `frequency` string
    - `hour` integer
    - `intervalAmount` integer
    - `intervalFrequency` string
    - `minute` integer
    - `startDate` string, date-time
    - `timeZone` string
    - `workdaysOnly` boolean
  - `state` string
  - `templateVars` object

## Response `200`

An OKResponse is returned if the request was successful.

- SuccessResponseBody
  - `message` string

## Other responses

- `400` — BadRequestError is returned when the request is invalid and it cannot be processed.
- `401` — UnauthorizedError is returned when the request is not authenticated.
- `403` — ForbiddenError is returned if the user/token has insufficient permissions to access the requested resource.
- `404` — NotFoundError is returned when the requested resource was not found.
- `500` — InternalServerError is a general error indicating something went wrong internally.

---

[API](https://skmtc.net/nforgeio/apis/grafana-http-api.md) · [All operations](https://skmtc.net/nforgeio/apis/grafana-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nforgeio/grafana-http-api/versions/3cb6c3f42dc7/schema)