Create a release

Creates a new release.

POST/v3/releases

JWT

release:write

Request Body Schema

Property	Type	Description	Constraints
name*	string	Name of the release. This can be a user friendly name to identify the release.	min: 1, max: 256
version*	string	The version of the release. Only following three formats are allowed x.x, x.x.x, x.x.x.x.	min: 1
channel*	string	Channel of the release. The default value is 'stable'.	min: 1, max: 256
platforms	array	Platforms of the release. It will usually have the following values: windows, linux, macos, win32, win64 etc.	items: string
private	boolean	Private releases don't appear in the customer portal.
notes	string	Release notes for the release. It also supports markdown.	min: 0, max: 4096
productId*	string	Unique identifier for the product.	min: 1, max: 256
createdAt	string	This property should only be used for creating old releases.	format: date-time

Request Example

{
  "name": "string",
  "version": "string",
  "channel": "string",
  "platforms": [
    "string"
  ],
  "private": true,
  "notes": "string",
  "productId": "string",
  "createdAt": "2019-08-24T14:15:22Z"
}

Triggers webhook: release.created

POST <your-webhook-url>
{
  "event": "release.created",
  "data": {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "name": "string",
    "channel": "string",
    "version": "string",
    "platforms": [
      "string"
    ],
    "notes": "string",
    "totalFiles": 0,
    "publishedAt": "2019-08-24T14:15:22Z",
    "files": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "url": "string",
        "size": 0,
        "downloads": 0,
        "extension": "string",
        "checksum": "string",
        "secured": true,
        "published": true,
        "releaseId": "string",
        "releaseName": "string"
      }
    ],
    "published": true,
    "private": true,
    "archived": true,
    "productId": "string",
    "tenantId": "string"
  },
  "triggeredAt": "string"
}

Responses

201

400

401

403

409

429

500

201 Created

{
  "id": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "name": "string",
  "channel": "string",
  "version": "string",
  "platforms": [
    "string"
  ],
  "notes": "string",
  "totalFiles": 0,
  "publishedAt": "2019-08-24T14:15:22Z",
  "files": [
    {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "url": "string",
      "size": 0,
      "downloads": 0,
      "extension": "string",
      "checksum": "string",
      "secured": true,
      "published": true,
      "releaseId": "string",
      "releaseName": "string"
    }
  ],
  "published": true,
  "private": true,
  "archived": true,
  "productId": "string",
  "tenantId": "string"
}