---
title: "Update an existing image profile."
method: PUT
path: "/authoring/v1/image-profiles/{id}"
tags: ["Authoring image profiles"]
---

# Update an existing image profile.

`PUT /authoring/v1/image-profiles/{id}`

Use the /image-profiles/{id} end-point to update an existing image profile within the database.<br />User roles: admin, manager

## Path parameters

- `id` string, required

## Query parameters

- `forceOverride` boolean

## Request body

- object — An existing image profile.
  - `id` string — The ID of the image profile.
  - `rev` string, required — The current revision of the image profile.
  - `name` string, required — The name of the image profile.
  - `description` string — The description of the image profile.
  - `classification` 'image-profile', required
  - `creatorId` string, required — The ID of the user that created the image profile.
  - `creator` string — The display name of the user that created the image profile. This field is only returned when the 'include' query string option is set to 'ALL' or 'metadata'. This field is read only.
  - `created` string, date-time — The created date of this image profile in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.
  - `lastModifierId` string — The ID of the user that last modified the image profile.
  - `lastModifier` string — The display name of the last user that modified the image profile. This field is only returned when the 'include' query string option is set to 'ALL' or 'metadata'. This field is read only.
  - `lastModified` string, date-time — The last modified date of this image profile in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.
  - `tags` string[]
  - `dimensions` object[], required
    - `label` string — The dimension label.
    - `key` string — The dimension key.
    - `description` string — The description of the dimension.
    - `width` number — The dimension's width
    - `height` number — The dimension's height
  - `isSystem` boolean — Indicates whether this item is a 'system item' or not.

## Response `200`

Success.

- object — An existing image profile.
  - `id` string — The ID of the image profile.
  - `rev` string, required — The current revision of the image profile.
  - `name` string, required — The name of the image profile.
  - `description` string — The description of the image profile.
  - `classification` 'image-profile', required
  - `creatorId` string, required — The ID of the user that created the image profile.
  - `creator` string — The display name of the user that created the image profile. This field is only returned when the 'include' query string option is set to 'ALL' or 'metadata'. This field is read only.
  - `created` string, date-time — The created date of this image profile in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.
  - `lastModifierId` string — The ID of the user that last modified the image profile.
  - `lastModifier` string — The display name of the last user that modified the image profile. This field is only returned when the 'include' query string option is set to 'ALL' or 'metadata'. This field is read only.
  - `lastModified` string, date-time — The last modified date of this image profile in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.
  - `tags` string[]
  - `dimensions` object[], required
    - `label` string — The dimension label.
    - `key` string — The dimension key.
    - `description` string — The description of the dimension.
    - `width` number — The dimension's width
    - `height` number — The dimension's height
  - `isSystem` boolean — Indicates whether this item is a 'system item' or not.

## Other responses

- `400` — Invalid ID or Invalid input.
- `401` — The user is not authorized to run this action.
- `404` — The document with ID {id} was not found OR Current tenant's database is not provisioned.
- `409` — Another user updated the document since it was last retrieved OR when changing the document name, there is an existing document with the chosen name.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `500` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)