---
title: "Create new image profiles."
method: POST
path: "/authoring/v1/image-profiles"
tags: ["Authoring image profiles"]
---

# Create new image profiles.

`POST /authoring/v1/image-profiles`

Use the /image-profiles end-point to create a new image profile.<br />User roles: admin, manager

## Request body

- object — An new image profile.
  - `name` string, required — The name of the image profile.
  - `description` string — The description of the image profile.
  - `classification` 'image-profile', required
  - `created` string, date-time — Optional creation date of this image profile in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. Value is ignored if set in the future.
  - `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` — Empty body or Invalid input.
- `404` — Current tenant's database is not provisioned.
- `409` — Image profile with the same name exists.
- `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)