POST /v2/cases — Create a support case
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Creates a new support case in Jira Service Management, linked to an order. Field requirements for the case are driven by the JSM request type — use GET /v2/jira-apis/request-type-groups and GET /v2/jira-apis/request-types to find the requestTypeId and its fields (GET /v2/cases/actions/getCaseTypes is deprecated for this purpose).
Required role
affiliate_super_admin, affiliate_admin, or affiliate_agent
Request body
| Field | Type | Required | Description |
|---|---|---|---|
requestTypeId | string | Yes | JSM request type ID — the externalCaseTypeIdentifier from GET /v2/jira-apis/request-types |
orderId | string | Yes | Order this case is linked to |
fields | object | No | Map of externalSystemIdentifier → value for the request type's fields. Any required field left out is auto-resolved from an order/patient variable where possible; if it still can't be resolved, the request fails with 422 |
Response 201
201{
"success": true,
"missingRequiredFields": [],
"data": {
"_id": "case::abc123",
"ticketId": "SUPPORT-43",
"ticketName": "Patient Support Request",
"ticketStatus": "open",
"ticketStatusLabel": "Open",
"relatedOrder": "order::abc123",
"reporter": null,
"createdBy": {
"displayName": "Jane Doe",
"email": "[email protected]",
"user_id": "usr::abc123"
},
"createdAt": "2026-05-30T14:00:00.000Z",
"resolvedAt": null,
"reopenedAt": null,
"firstResponseTime": null,
"priority": null,
"updatedAt": "2026-05-30T14:00:00.000Z",
"externalCaseUrl": "https://telegramd.atlassian.net/servicedesk/customer/portal/1/SUPPORT-43"
}
}There is no top-level jiraRequest, case, requestFieldValues, summary, jiraKey, status, or priority field on the response — use data.ticketId (the Jira issue key) and data.ticketStatus/data.ticketStatusLabel. The raw JSM request and case document are no longer returned; only success, missingRequiredFields, and data are.
Errors
| Status | Code | Description |
|---|---|---|
| 422 | INVALID_FIELD | requestTypeId or orderId missing, or a required JSM field couldn't be resolved (see missingRequiredFields in the error body) |
| 404 | — | Request type, order, or patient not found |
