POST Create Release

URL: http://{{server-url}}/api/v1/release

In order to create a new release, you have to call the above endpoint with the following key-values:

Header

Key	Description
Authorization	Bearer {access token obtained after authorization}
Content-Type	application/json

Body

You would be sending a JSON release request that will create a ticket and populate its details. Some of the key-value pairs are compulsory, notice the description of each.

note

Keys with asterisk are mandatory.

Key	Value Type	Description
requesterEmail*	String	Email address of the user registered for the client.
subject*	String	Subject of the release.
startDate*	long	Set the start date and time when the release was initiated.
endDate*	long	Set the end date to resolve/close the release.
priorityName	String	Shows the importance of the Release. Possible values are: Low, Medium, High, or Urgent.
urgencyName	String	Marks the Release as urgent. Possible values are: Low, Medium, High, or Urgent.
impactName	String	Describes the effect of the Release. Possible values are: Low, On User, On Department, or On Business.
riskTypeName	String	Marks the type of risk involved in the release. The possible values are: Low, Medium, or High.
releaseTypeName	String	Marks the type of release. The possible values are: Minor, Major, or Emergency.
categoryName	String	Category name assigned to the release.
locationName	String	Name of the Location where the release is happening. Note that Location must exist with the same name.
tags	String Array	Additional identifiers attached to a ticket. It is a list that can contain n number of STRINGS.
departmentName	String	Department associated with the release.
assigneeEmail	String	Email address of the Assignee.
technicianGroupName	String	Name of the technician group.
description	String	Description about the release.
reasonTypeName	String	Reason for the release. For example: Upgrade Existing, New Implementation.
releaseEngineerEmail	String	Email address of the Release Engineer.
releaseManagerEmail	String	Email address of the Release Manager.
qaManagerEmail	String	Email address of the QA Manager.
releaseReviewerEmail	String	Email address of the Release Reviewer.
businessServiceNames	String Array	List of business services affected by this release.
customField	Object	Custom field values for the release. For example: `{ "Dropdown 1": "value", "Multi-Select": [] }`
fileAttachments	Object Array	Reference file names of attachments for a Release. For example: `[ { "refFileName": "abc", "realName": "xyz.pdf" } ]`

Example (Request & Response)

Request

curl --location 'http://172.16.11.160/api/v1/release' \
--header 'Authorization: Bearer eyJraWQiOiJmbG90by1rZXktaWQiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJqZXJyeUBtb3RhZGF0YS5jb20iLCJ1c2VyX25hbWUiOiJ1dWlkMzYtZmNkMjA3MmItMzA5My00MDA1LWFjNWEtYjNkMzVlZGIxZWI3IiwiaXNzIjoiaHR0cDovLzE3Mi4xNi4xMS4xNjAvYXBpIiwibG9naW5fc291cmNlIjoiTk9STUFMX0xPR0lOIiwiY2xpZW50X2lkIjoiZmxvdG8td2ViLWFwcCIsImF1ZCI6ImZsb3RvLXdlYi1hcHAiLCJsb2dpbl9zc29faWQiOjAsIm5iZiI6MTc4MDA0MzA4NSwiZ3JhbnRfdHlwZSI6InBhc3N3b3JkIiwic2NvcGUiOlsiTk8tU0NPUEUiXSwiZXhwIjoxNzgwMjE1ODg1LCJsb2dpbl9tc3BfcG9ydGFsX2lkIjowLCJpYXQiOjE3ODAwNDMwODUsImp0aSI6IjZjODg1ZTBmLTUzZjctNGIxMi04ZmVhLTIzZjU0NDM4OTcwNyIsInRlbmFudElkZW50aWZpZXIiOiJhcG9sbyJ9.ImjyUr195fh1fNS88fwe9YPU6_zQ_hwUpDRxymyxO2ch3kxItvjis589AWQmGnPwDNGFip0mhIX1pqVEMpgY_WyJhGt_T6XyQD3-vA9WIrX8zcv4A6CWmomK6IUQGzUwv1J6ktlrxoNG9xeEAhxA3IwIGulMX7EpUpp_3D1l8d_VO1FvheP7IZdnK0e_eoRD9sRAxTj7fKqYmhN_4M69KKyUO1VIk3D0hRbeVizROI1arIkAGlhNj30RchqvsD8pt-JMEE8YjslFeNqAXeClyv7x9eZ-YgWfYVN0_zib_xWbJT8Jrym_h-j9zShRpm-ePro0uP6R-1ClFbb-2J0RkQ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requesterEmail": "jerry@motadata.com",
    "subject": "New Software Release v8.7.4",
    "startDate": 1777877700000,
    "endDate": 1779951300000,
    "priorityName": "Medium",
    "urgencyName": "Low",
    "impactName": "On Users",
    "riskTypeName": "Medium",
     "departmentName": "HR",
     "description": "<p>New software version with features, enhancements, and bug fixes.</p>",
     "releaseTypeName":"Major",
     "locationName":"Asia",
     "categoryName":"General",
    "reasonTypeName": "Upgrade Existing",
    "releaseEngineerEmail": "jerry@motadata.com",
    "releaseManagerEmail": "shraddha",
    "qaManagerEmail": "shraddha",
    "releaseReviewerEmail": "jerry@motadata.com",
    "businessServiceNames": [ ],
    "customField": {
        "Dropdown 1": "",
        "Dropdown 2": "34",
        "New Multi-Select Dropdown": []
    }
}'

Response

{
    "id": 8,
    "categoryName": "General",
    "name": "REL-8",
    "createdTime": 1780049526234,
    "updatedTime": 1780049526257,
    "departmentName": "HR",
    "customField": {
        "New Text Input": ""
    },
    "statusName": "Requested",
    "createdByName": "Jerry",
    "subject": "New Software Release v8.7.4",
    "requesterName": "Jerry",
    "fileAttachments": [],
    "requesterEmail": "jerry@motadata.com",
    "description": "New software version with features, enhancements, and bug fixes.",
    "locationName": "Asia",
    "impactName": "On Users",
    "priorityName": "Medium",
    "urgencyName": "Low",
    "updatedByName": "Jerry",
    "solutionUpdatedTime": 0,
    "createdTimeAt": "29/05/2026 03:42 pm",
    "updatedTimeAt": "29/05/2026 03:42 pm",
    "releaseEngineerEmail": "jerry@motadata.com",
    "releaseManagerEmail": "shraddha.lal@motadata.com",
    "qaManagerEmail": "shraddha.lal@motadata.com",
    "releaseReviewerEmail": "jerry@motadata.com",
    "riskTypeName": "Medium",
    "releaseTypeName": "Major",
    "reasonTypeName": "Upgrade Existing",
    "startDate": 1777877700000,
    "endDate": 1779951300000,
    "impactFileAttachments": [],
    "backoutPlanFileAttachments": [],
    "rolloutPlanFileAttachments": [],
    "buildPlanFileAttachments": [],
    "testPlanFileAttachments": [],
    "dueBy": "08/06/2026 03:42 pm",
    "lastApprovedDate": 0,
    "slaName": "tets"
}

Example (Request & Response)​

Example (Request & Response)