---
title: "Update an existing Insights Report"
method: PUT
path: "/{spaceId}/insights/reports/{id}"
tags: ["Insights"]
---

# Update an existing Insights Report

`PUT /{spaceId}/insights/reports/{id}`

Updates an existing Insights Report

## Path parameters

- `spaceId` string, required
- `id` string, required

## Request body

- ModifyInsightsReportCommand — Updates an existing Insights Report
  - `AllTenants` boolean, required — If true, all tenants in the space will be included in the report.
  - `ChannelIds` string[], required — The channels for the report.
  - `Description` string — The description for the report.
  - `EnvironmentGroups` InsightsEnvironmentGroupResource[], required — The environment groups for the report.
    - `Environments` string[], required
    - `Name` string, required
  - `Id` string, required — The Id of the Insights Report
  - `Name` string, required — The name of the report.
  - `ProjectGroupIds` string[], required — The project groups for the report.
  - `ProjectIds` string[], required — The projects for the report.
  - `SpaceId` string, required — The ID of the space containing the resource(s).
  - `TenantIds` string[], required — The tenants for the report.
  - `TenantMode` 'Untenanted' | 'TenantedAndUntenanted' | 'Tenanted', required — The kind of deployments that will be included in this report
  - `TenantTags` string[], required — The tenant tags for the report.
  - `TimeZone` string, required — The timezone of the report.

## Response `200`

Success

- InsightsReportResource
  - `AllTenants` boolean, required
  - `ChannelIds` string[], required
  - `Description` string
  - `EnvironmentGroups` InsightsEnvironmentGroupResource[], required
    - `Environments` string[], required
    - `Name` string, required
  - `IconColor` string
  - `IconId` string
  - `Id` string — Gets or sets a unique identifier for this resource.
  - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
  - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
  - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
  - `Name` string, required
  - `ProjectGroupIds` string[], required
  - `ProjectIds` string[], required
  - `SpaceId` string, required
  - `TenantIds` string[], required
  - `TenantMode` 'Untenanted' | 'TenantedAndUntenanted' | 'Tenanted', required
  - `TenantTags` string[], required
  - `TimeZone` string, required

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

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