Skip to main content

POST Create a Conversation

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

Example: http://172.16.11.160/api/v1/release/9/conversation

You can create a conversation (collaborate and note) within a release by calling the above endpoint with the ticket ID.

You need the following key-values:

Header

KeyDescription
AuthorizationBearer/API Key {access token obtained after authorization}

Body

{
"conversationType": "collaborate",
"details": "<p>This is an internal note about the release progress.</p>",
"subject": "Release Kickoff"
},
{
"conversationType": "note",
"details": "<p>This is an internal note about the release progress.</p>",
"subject": "Progress Update",
"conversationState": "published"
}

Example (Request & Response)

Request

curl --location 'http://172.16.11.160/api/v1/release/9/conversation' \
--header 'Authorization: Apikey UMKSU3dhE8ERESeb%40LiklySVfaJL2i42wh%2Behea9x%2FmW46Uu5YZUz6YnxFSyQ6w%3D%3D' \
--header 'Content-Type: application/json' \
--data '{
"conversationType": "collaborate",
"details": "This is an internal note about the release progress.",
"subject": "Release Info"
},
{
"conversationType": "note",
"details": "<p>This is an internal note about the request progress.</p>",
"subject": "Progress Update",
"conversationState": "published"
}
'

Response

{
"id": 162,
"conversationType": "collaborate",
"details": "This is an internal note about the release progress.",
"createdByName": "Jerry",
"createdByEmail": "jerry@motadata.com",
"createdTime": "Fri, May 29, 2026 06:12 pm",
"updatedTime": "Fri, May 29, 2026 06:12 pm",
"subject": "Release Info",
"conversationState": "published",
"updatable": false,
"deletable": true,
"fileAttachments": []
}