# Update Analytics Page Version

Give a version a name or notes so its history reads well.

`PUT https://connect.mindcloud.co/v2/analytics/pages/:pageId/versions/:versionId`

Permissions: `analytics:page:edit`.

## Parameters

### Path

- `pageId` (string, required): The page id, from List Analytics Pages.
- `versionId` (string, required): The version id, from List Analytics Page Versions.

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. Here a key acts in another organization only as one of its members: with "Use this key across all of your organizations" on, in an organization its creator belongs to with a role. Child organizations and MindCloud staff access do not reach this endpoint. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

### Body

- `name` (string): The version name.
- `notes` (string): Notes on what changed.

## Example request

```bash
curl --request PUT \
  --url 'https://connect.mindcloud.co/v2/analytics/pages/Pq7Lm2Xc9RtA/versions/Vr2Lc7Pq9XmA' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Q3 board review",
  "notes": "Added the churn panel and the region filter."
}'
```

## Response fields

- `id` (string): The version id.
- `version` (number): The version number, counting up from 1.
- `name` (string): Its name, or null.
- `notes` (string): Its notes, or null.
- `isPublished` (boolean): Whether it is the version viewers see.
- `createdBy` (string): The userId of who published it, from List Members, or null.
- `createdByName` (string): Who published it, or null.
- `createdOn` (date): When it was made.
- `publishedOn` (date): When it was last made the version viewers see, or null.
