---
title: "POST /api/v1/release"
method: POST
path: "/api/v1/release"
tags: ["Release"]
---

# POST /api/v1/release

`POST /api/v1/release`

## Request body

- ReleaseResource
  - `id` integer
  - `guid` string, nullable
  - `quality` QualityModel
    - `quality` Quality
      - `id` integer
      - `name` string, nullable
    - `revision` Revision
      - `version` integer
      - `real` integer
      - `isRepack` boolean
  - `qualityWeight` integer
  - `age` integer
  - `ageHours` number, double
  - `ageMinutes` number, double
  - `size` integer
  - `indexerId` integer
  - `indexer` string, nullable
  - `releaseGroup` string, nullable
  - `subGroup` string, nullable
  - `releaseHash` string, nullable
  - `title` string, nullable
  - `discography` boolean
  - `sceneSource` boolean
  - `airDate` string, nullable
  - `artistName` string, nullable
  - `albumTitle` string, nullable
  - `approved` boolean
  - `temporarilyRejected` boolean
  - `rejected` boolean
  - `rejections` string[], nullable
  - `publishDate` string, date-time
  - `commentUrl` string, nullable
  - `downloadUrl` string, nullable
  - `infoUrl` string, nullable
  - `downloadAllowed` boolean
  - `releaseWeight` integer
  - `customFormats` CustomFormatResource[], nullable
    - `id` integer
    - `name` string, nullable
    - `includeCustomFormatWhenRenaming` boolean, nullable
    - `specifications` CustomFormatSpecificationSchema[], nullable
      - `id` integer
      - `name` string, nullable
      - `implementation` string, nullable
      - `implementationName` string, nullable
      - `infoLink` string, nullable
      - `negate` boolean
      - `required` boolean
      - `fields` Field[], nullable
        - `order` integer
        - `name` string, nullable
        - `label` string, nullable
        - `unit` string, nullable
        - `helpText` string, nullable
        - `helpTextWarning` string, nullable
        - `helpLink` string, nullable
        - `value` unknown
        - `type` string, nullable
        - `advanced` boolean
        - `selectOptions` SelectOption[], nullable
          - `value` integer
          - `name` string, nullable
          - `order` integer
          - `hint` string, nullable
        - `selectOptionsProviderAction` string, nullable
        - `section` string, nullable
        - `hidden` string, nullable
        - `privacy` 'normal' | 'password' | 'apiKey' | 'userName'
        - `placeholder` string, nullable
        - `isFloat` boolean
      - `presets` CustomFormatSpecificationSchema[], nullable
  - `customFormatScore` integer
  - `magnetUrl` string, nullable
  - `infoHash` string, nullable
  - `seeders` integer, nullable
  - `leechers` integer, nullable
  - `protocol` 'unknown' | 'usenet' | 'torrent'
  - `indexerFlags` integer
  - `artistId` integer, nullable
  - `albumId` integer, nullable
  - `downloadClientId` integer, nullable
  - `downloadClient` string, nullable

## Response `200`

OK

- ReleaseResource
  - `id` integer
  - `guid` string, nullable
  - `quality` QualityModel
    - `quality` Quality
      - `id` integer
      - `name` string, nullable
    - `revision` Revision
      - `version` integer
      - `real` integer
      - `isRepack` boolean
  - `qualityWeight` integer
  - `age` integer
  - `ageHours` number, double
  - `ageMinutes` number, double
  - `size` integer
  - `indexerId` integer
  - `indexer` string, nullable
  - `releaseGroup` string, nullable
  - `subGroup` string, nullable
  - `releaseHash` string, nullable
  - `title` string, nullable
  - `discography` boolean
  - `sceneSource` boolean
  - `airDate` string, nullable
  - `artistName` string, nullable
  - `albumTitle` string, nullable
  - `approved` boolean
  - `temporarilyRejected` boolean
  - `rejected` boolean
  - `rejections` string[], nullable
  - `publishDate` string, date-time
  - `commentUrl` string, nullable
  - `downloadUrl` string, nullable
  - `infoUrl` string, nullable
  - `downloadAllowed` boolean
  - `releaseWeight` integer
  - `customFormats` CustomFormatResource[], nullable
    - `id` integer
    - `name` string, nullable
    - `includeCustomFormatWhenRenaming` boolean, nullable
    - `specifications` CustomFormatSpecificationSchema[], nullable
      - `id` integer
      - `name` string, nullable
      - `implementation` string, nullable
      - `implementationName` string, nullable
      - `infoLink` string, nullable
      - `negate` boolean
      - `required` boolean
      - `fields` Field[], nullable
        - `order` integer
        - `name` string, nullable
        - `label` string, nullable
        - `unit` string, nullable
        - `helpText` string, nullable
        - `helpTextWarning` string, nullable
        - `helpLink` string, nullable
        - `value` unknown
        - `type` string, nullable
        - `advanced` boolean
        - `selectOptions` SelectOption[], nullable
          - `value` integer
          - `name` string, nullable
          - `order` integer
          - `hint` string, nullable
        - `selectOptionsProviderAction` string, nullable
        - `section` string, nullable
        - `hidden` string, nullable
        - `privacy` 'normal' | 'password' | 'apiKey' | 'userName'
        - `placeholder` string, nullable
        - `isFloat` boolean
      - `presets` CustomFormatSpecificationSchema[], nullable
  - `customFormatScore` integer
  - `magnetUrl` string, nullable
  - `infoHash` string, nullable
  - `seeders` integer, nullable
  - `leechers` integer, nullable
  - `protocol` 'unknown' | 'usenet' | 'torrent'
  - `indexerFlags` integer
  - `artistId` integer, nullable
  - `albumId` integer, nullable
  - `downloadClientId` integer, nullable
  - `downloadClient` string, nullable

---

[API](https://skmtc.net/lidarr/apis/lidarr.md) · [All operations](https://skmtc.net/lidarr/apis/lidarr/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lidarr/lidarr/versions/4ae9e79e9662/schema)