---
title: "Create a new rendition."
method: POST
path: "/authoring/v1/renditions"
tags: ["Authoring renditions"]
---

# Create a new rendition.

`POST /authoring/v1/renditions`

Use this endpoint to create a new rendition. The rendition will have resizing parameters applied before the crop is conducted. The generated rendition link will depend on the parameters provided. The scale parameter is required to resize. LocationX, locationY, width and height parameters are required to crop.<br />User roles: admin, manager, editor

## Query parameters

- `fields` string[]
- `include` string[]
- `projectId` string

## Request body

- object
  - `locationX` integer — Offset from the top left corner in the x dimension for where the crop will begin
  - `locationY` integer — Offset from the top left corner in the y dimension for where the crop will begin
  - `width` integer — Width of the crop
  - `height` integer — Height of the crop
  - `scale` number — Size image will be scaled to
  - `asset` object, required
    - `id` string, required — The id of the asset this rendition is for
  - `id` string — The id of the rendition to create

## Response `201`

Successfully created a new rendition.

- object
  - `locationX` integer — Offset from the top left corner in the x dimension for where the crop will begin
  - `locationY` integer — Offset from the top left corner in the y dimension for where the crop will begin
  - `width` integer — Width of the crop
  - `height` integer — Height of the crop
  - `scale` number — Size image will be scaled to
  - `asset` object, required
    - `id` string, required — The id of the asset this rendition is for
  - `id` string, required — The id of the rendition
  - `rev` string, required — The revision of the rendition
  - `classification` 'rendition', required — The classification of a rendition is always "rendition"
  - `fileName` string, required — File name of the resource
  - `mediaType` string, required — Media type of the resource
  - `resource` string, required — the id of the uploaded resource this rendition is for
  - `links` object
    - `self` object, required — Relative link to the rendition
      - `href` string, required — Relative url
    - `media` object, required — Relative link to the rendition applied to the resource
      - `href` string, required — Relative url
    - `asset` object, required — Relative link to the asset
      - `href` string, required — Relative url
    - `resource` object, required — Relative link to the rendition
      - `href` string, required — Relative url

## Other responses

- `400` — The required parameters are missing or invalid, or the number of allowed renditions have been reached. Please read the error message and alter the request accordingly.
- `409` — A rendition already exists with the given ID.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `503` — Connection failed to datastore.
- `default` — 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)