Imported data
bearerAuth Bearer Token (JWT) | Recurso | Descripción |
|---|---|
| Ticket | Ticket operations |
| Comment | Comments operations |
| Attachment | Attachments operations |
| Grid | Grid operations |
| IssueLinkTypes | Issue link types operations |
| IssueLink | Issue links operations |
| Remotelink | Remote links operations |
| Customfield | Custom fields operations |
| Insight | Jira Insight operations |
| IaSummary | IA Summary operations |
| IaDuration | IA duration prediction operations |
bearerAuth Bearer Token (JWT) | Recurso | Descripción |
|---|---|
| Ticket | Ticket operations |
| Comment | Comments operations |
| Attachment | Attachments operations |
| Grid | Grid operations |
| IssueLinkTypes | Issue link types operations |
| IssueLink | Issue links operations |
| Remotelink | Remote links operations |
| Customfield | Custom fields operations |
| Insight | Jira Insight operations |
| IaSummary | IA Summary operations |
| IaDuration | IA duration prediction operations |
Creates a ticket from a JSON representation.
PATH PARAMETERS
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
Json with ticket creation fields. See request ticket/metadata/create/properties.
{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
key | string | Ticket key reference. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
project | string | Project key. RED, PROV, INST, etc. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ticketType | string | Ticket type. You can query available values using Get Ticket Types request. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
summary | string | A simple summary for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description | string | A detail description for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
components | string[] | Components list. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customFields | object | Object containing extra custom fields depending on ticket typology | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id | string | Ticket id assigned by the ticketing provider. This is not the same identifier as `key`: endpoints taking a `ticketId` path parameter expect the `key`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | string | Current ticket status, translated to English when a translation is configured for the provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
priority | string | Ticket priority name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assignee | string | Username of the user the ticket is currently assigned to. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
reporter | string | Username of the user that reported the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resolution | string | Resolution name. Only present once the ticket has been resolved. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate | string | Creation datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updatedDate | string | Last update datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
labels | string[] | Labels set on the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
attachments | object[] | Attachment metadata for the files attached to the ticket. Omitted when the ticket has no attachments. Use `GET /ticket/{ticketId}/attachment/{attachmentId}` to download the content. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comments | object[] | Comments added to the ticket. Omitted when the ticket has no comments. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
issueLinks | object[] | Links between this ticket and other tickets. Omitted when the ticket has no links. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
histories | object[] | Changelog entries for the ticket. Only returned when the request asks the provider for the changelog through `expand=changelog`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Created Entity has been created succesfully.
{
"id": 3645,
"key": "INST-1341"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
id | integer | Ticket ID | ||
key | string | Ticket Key. You could reference the ticket by its key or by ID |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X POST 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}'Returns a full representation of the ticket for the given key.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Full representation of the ticket
{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
key | string | Ticket key reference. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
project | string | Project key. RED, PROV, INST, etc. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ticketType | string | Ticket type. You can query available values using Get Ticket Types request. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
summary | string | A simple summary for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description | string | A detail description for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
components | string[] | Components list. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customFields | object | Object containing extra custom fields depending on ticket typology | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id | string | Ticket id assigned by the ticketing provider. This is not the same identifier as `key`: endpoints taking a `ticketId` path parameter expect the `key`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | string | Current ticket status, translated to English when a translation is configured for the provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
priority | string | Ticket priority name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assignee | string | Username of the user the ticket is currently assigned to. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
reporter | string | Username of the user that reported the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resolution | string | Resolution name. Only present once the ticket has been resolved. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate | string | Creation datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updatedDate | string | Last update datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
labels | string[] | Labels set on the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
attachments | object[] | Attachment metadata for the files attached to the ticket. Omitted when the ticket has no attachments. Use `GET /ticket/{ticketId}/attachment/{attachmentId}` to download the content. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comments | object[] | Comments added to the ticket. Omitted when the ticket has no comments. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
issueLinks | object[] | Links between this ticket and other tickets. Omitted when the ticket has no links. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
histories | object[] | Changelog entries for the ticket. Only returned when the request asks the provider for the changelog through `expand=changelog`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Edits a ticket from a JSON representation.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
Json with fields to update. See request /ticket/{ticketId}/metadata/update/properties.
{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
key | string | Ticket key reference. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
project | string | Project key. RED, PROV, INST, etc. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ticketType | string | Ticket type. You can query available values using Get Ticket Types request. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
summary | string | A simple summary for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description | string | A detail description for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
components | string[] | Components list. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customFields | object | Object containing extra custom fields depending on ticket typology | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id | string | Ticket id assigned by the ticketing provider. This is not the same identifier as `key`: endpoints taking a `ticketId` path parameter expect the `key`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | string | Current ticket status, translated to English when a translation is configured for the provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
priority | string | Ticket priority name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assignee | string | Username of the user the ticket is currently assigned to. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
reporter | string | Username of the user that reported the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resolution | string | Resolution name. Only present once the ticket has been resolved. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate | string | Creation datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updatedDate | string | Last update datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
labels | string[] | Labels set on the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
attachments | object[] | Attachment metadata for the files attached to the ticket. Omitted when the ticket has no attachments. Use `GET /ticket/{ticketId}/attachment/{attachmentId}` to download the content. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comments | object[] | Comments added to the ticket. Omitted when the ticket has no comments. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
issueLinks | object[] | Links between this ticket and other tickets. Omitted when the ticket has no links. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
histories | object[] | Changelog entries for the ticket. Only returned when the request asks the provider for the changelog through `expand=changelog`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
No Content No content
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X PATCH 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}'This method allows you search ticket by JQL (Jira Query Language)
PATH PARAMETERS
Organization name as it is registered in Mas-Stack
QUERY PARAMETERS
jql query
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Ticket Search response
{
"startAt": 0,
"maxResults": 50,
"total": 3,
"tickets": [
{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}
]
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
startAt | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
maxResults | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
total | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tickets | object[] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/search/ticket?jql=string' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'This method allows you to search tickets filtering and ordering as you need.<br> Special opeators are allowed $like: value<br> $in: [array]<br> $notIn: [array]<br> $isEmpty: ""<br> $greaterThanEquals: value<br> $greaterThan: value<br> $lessThanEquals: value<br> $lessThan: value<br> Field names used in filters can be both Jira field name or MAS-Ticketing-API name, i.e. you can use "customerDocument" or "Documento Cliente".
PATH PARAMETERS
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
Filters to apply to search query
{
"filters": {
"project": "MAS",
"issuetype": {
"$in": [
"Avería (FTTH)",
"Avería (xDSL)"
]
},
"status": {
"$notIn": [
"Resolved",
"Descartado",
"CLOSE"
]
},
"massiveFaults": {
"$isEmpty": ""
}
},
"orderby": {
"fields": [
"status desc"
]
},
"startAt": 0,
"maxResults": 100
}| Property | Type | Description | Constraints | Default | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
filters
*
| object | Non-empty object keyed by API field name. Values can be direct values or operator objects using $like, $in, $notIn, $isEmpty, $greaterThanEquals, $greaterThan, $lessThanEquals or $lessThan. | ||||||||||||
| object | ||||||||||||||
orderby | object | Fields to order by, optionally followed by ASC or DESC (for example, key ASC) | ||||||||||||
| ||||||||||||||
fields | string[] | This property allows you filter the fields you want in the response body | ||||||||||||
expand | string[] | Jira fields to expand in the response | ||||||||||||
startAt | integer | Start position in the complete result, you want as firt item in the response body | ||||||||||||
maxResults | integer | Numbers of items you want back | ||||||||||||
OK Ticket response
[
{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}
]| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
key | string | Ticket key reference. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
project | string | Project key. RED, PROV, INST, etc. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ticketType | string | Ticket type. You can query available values using Get Ticket Types request. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
summary | string | A simple summary for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description | string | A detail description for the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
components | string[] | Components list. See Field Information request to query available values and field information. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customFields | object | Object containing extra custom fields depending on ticket typology | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id | string | Ticket id assigned by the ticketing provider. This is not the same identifier as `key`: endpoints taking a `ticketId` path parameter expect the `key`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | string | Current ticket status, translated to English when a translation is configured for the provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
priority | string | Ticket priority name. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assignee | string | Username of the user the ticket is currently assigned to. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
reporter | string | Username of the user that reported the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
resolution | string | Resolution name. Only present once the ticket has been resolved. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdDate | string | Creation datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updatedDate | string | Last update datetime, in the format returned by the ticketing provider. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
labels | string[] | Labels set on the ticket. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
attachments | object[] | Attachment metadata for the files attached to the ticket. Omitted when the ticket has no attachments. Use `GET /ticket/{ticketId}/attachment/{attachmentId}` to download the content. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comments | object[] | Comments added to the ticket. Omitted when the ticket has no comments. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
issueLinks | object[] | Links between this ticket and other tickets. Omitted when the ticket has no links. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
histories | object[] | Changelog entries for the ticket. Only returned when the request asks the provider for the changelog through `expand=changelog`. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X POST 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/search/ticket' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"filters": {
"project": "MAS",
"issuetype": {
"$in": [
"Avería (FTTH)",
"Avería (xDSL)"
]
},
"status": {
"$notIn": [
"Resolved",
"Descartado",
"CLOSE"
]
},
"massiveFaults": {
"$isEmpty": ""
}
},
"orderby": {
"fields": [
"status desc"
]
},
"startAt": 0,
"maxResults": 100
}'Performs a search returning tickets corresponding to the territory-owner in path
PATH PARAMETERS
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Search by territory owner response
{
"startAt": 0,
"maxResults": 50,
"total": 3,
"tickets": [
{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}
]
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
startAt | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
maxResults | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
total | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tickets | object[] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/searchByTerritoryOwner' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Performs a search returning tickets based on ID parameters. At least one of the following parameters must be provided: customer_id, work_order_id, line, or document_id.
PATH PARAMETERS
Organization name as it is registered in Mas-Stack
QUERY PARAMETERS
Customer ID to search for tickets
Work Order ID to search for tickets
Line number to search for tickets
Document ID to search for tickets
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Search by ID parameters response
{
"startAt": 0,
"maxResults": 50,
"total": 3,
"tickets": [
{
"key": "INST-7902",
"project": "INST",
"ticketType": "Incidencia",
"description": "Cita - Cliente solicita contacto en fecha concreta - Y28257924",
"summary": "Cita - Y28257924",
"customFields": {
"segment": "Residencial",
"brand": "Yoigo",
"category": "Cita",
"subcategory": "Cliente solicita contacto en fecha concreta",
"work_order_id": "Y28257924"
}
}
]
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
startAt | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
maxResults | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
total | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tickets | object[] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/searchByIDParams?customer_id=12345&work_order_id=WO123456&line=678900000&document_id=12345678X' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Get information about allowed transitions for a ticket, depending on current status.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Transitions response
{
"transitions": [
{
"id": "41",
"name": "Reasignar",
"status": "Asignado"
},
{
"id": "21",
"name": "Resolver",
"status": "RESUELTO"
}
]
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
transitions
*
| object[] | |||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923/transitions' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'This method allows you to execute a transition, i.e. change ticket status.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
{
"transitionId": 111,
"customFields": {
"external_system_name": "Orange",
"external_system_info": "Prueba de escalado externo via API de robot",
"external_system_category": "Instalación"
}
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
transitionId
*
| integer | Transition Id reference to operate with. | ||
status | string | Status name reference to operate with. It´s optional, you can reference by transitionId or status | ||
customFields | object | Custom fields to update during the transition. Use actual Jira custom field names as properties (e.g., external_system_name, external_system_info, solution_detail, etc.). Only fields allowed by the specific transition will be processed. | ||
| object | ||||
No Content No content
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X POST 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923/transitions' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"transitionId": 111,
"customFields": {
"external_system_name": "Orange",
"external_system_info": "Prueba de escalado externo via API de robot",
"external_system_category": "Instalación"
}
}'Assign a ticket to some user
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
{
"assignee": "admin.micro"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
assignee
*
| string | user id, username o email. |
No Content No content
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X PUT 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923/assignee' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"assignee": "admin.micro"
}'Get information about fields needed to create a given type of ticket
QUERY PARAMETERS
The project key in MasMovil ticketing tool
The ticket type in MasMovil ticketing tool
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Fields for ticket type
{
"subscriptionNumber": {
"required": true,
"name": "Suscripción"
},
"icc": {
"required": false,
"name": "ICC"
},
"contactEmail": {
"required": false,
"name": "Email del Cliente"
}
}| Property | Type | Description | Constraints | Default | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
subscriptionNumber | object | Field example | |||||||||||||||||
| |||||||||||||||||||
icc | object | Field example | |||||||||||||||||
| |||||||||||||||||||
contactEmail | object | Field example | |||||||||||||||||
| |||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/ticket/metadata/create/properties?projectKey=string&ticketType=string' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Get information about editable fields.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Editable Fields for ticket
{
"description": {
"name": "Descripción"
},
"customerPostalCode": {
"name": "Código Postal"
},
"customerSegment": {
"name": "Segmento Cliente",
"allowedValues": [
{
"value": "EMPRESA"
},
{
"value": "RESIDENCIAL"
},
{
"value": "HORECA"
},
{
"value": "AUTONOMO"
}
]
}
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
description | object | Field example | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||
customerPostalCode | object | Field example | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||
customerSegment | object | Field example | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/ticket/ATC-20923/metadata/update/properties' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Get information about ticket types per project
PATH PARAMETERS
The project key in MasMovil ticketing tool
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Get ticket types
[
[
{
"projectKey": "EKT",
"name": "Euskaltel",
"issuetypes": [
{
"name": "Aviso de llamada perdida",
"description": "Incidencia-Servicios"
},
{
"name": "Contestador",
"description": "Incidencia-Servicios"
},
{
"name": "No salta el aviso de saldo",
"description": "Incidencia-Servicios"
}
]
},
{
"projectKey": "MM",
"name": "MásMóvil Customer Care",
"issuetypes": [
{
"name": "Problemas TV",
"description": "Incidencia"
},
{
"name": "Desacuerdo con la cuota de TV",
"description": "Incidencia"
},
{
"name": "Bloqueo por IMEI-Tarea",
"description": "Tarea-Móvil"
}
]
}
]
]| Property | Type | Description | Constraints | Default | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
projectKey | string | Project key reference | |||||||||||||||||
name | string | Project name | |||||||||||||||||
issuetypes | object[] | Issue types list with all types available | |||||||||||||||||
Array items:
| |||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/ticket/metadata/:projectKey/types' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Get information about api names with api_name, customfield_id or jira_label params (Only one)
QUERY PARAMETERS
Search a field information with api name
Search a field information with customfield_id
Search a field information with the TGJira field name
Optional squad requesting additional field information
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Get field info successfully
{
"jira_label": "Huella",
"api_name": "track",
"customfield_id": "customfield_12800"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
jira_label | string | |||
api_name | string | |||
customfield_id | string |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/ticket/field/info?api_name=track&customfield_id=customfield_12800&jira_label=Huella&squad=ticketing' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'This method allows you to add a comment in a ticket
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
Properties ticketId and body are mandatory.
{
"ticketId": "INST-3241",
"body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat."
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
ticketId | string | Ticket key in `PROJECT-NUMBER` format (e.g. `ATC-20923`). Use the key, not the numeric id (e.g. `937328`) — they are different identifiers. | ||
author | string | Comment author, must match with ticketing provider user. | ||
body
*
| string | The text you want to add as a comment to the ticket | ||
createdDate | string | Datetime the comment was created, in the format returned by the ticketing provider. | ||
updatedDate | string | Datetime the comment was last edited, in the format returned by the ticketing provider. |
Created Created
{
"ticketId": "INST-3241",
"body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat."
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
ticketId | string | Ticket key in `PROJECT-NUMBER` format (e.g. `ATC-20923`). Use the key, not the numeric id (e.g. `937328`) — they are different identifiers. | ||
author | string | Comment author, must match with ticketing provider user. | ||
body
*
| string | The text you want to add as a comment to the ticket | ||
createdDate | string | Datetime the comment was created, in the format returned by the ticketing provider. | ||
updatedDate | string | Datetime the comment was last edited, in the format returned by the ticketing provider. |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X POST 'https://ticketing.sta.masstack.com/v2/ticket/ATC-20923/comment' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"ticketId": "INST-3241",
"body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat."
}'Attach a file in a specific ticket
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
The properties ticketId, name and data are required. Data must be base64 encoded.
{
"name": "MYSIM_3847484.pdf",
"data": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxITEhUSEhMVFhUXGBcVFxUVFRUVF...",
"mimeType": "image/jpeg"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
name
*
| string | File name | ||
data
*
| string | File content in base64 format | ||
mimeType | string | The file mime type. See https://docs.w3cub.com/http/basics_of_http/mime_types/complete_list_of_mime_types |
Created Attachment Created synchronous response
{
"self": "https://mas-ticketing-sta.dev-01.k8s.masmovil.com/mas-ticketing-api/ticket/73232/attachment/24819",
"content": "https://mas-ticketing-sta.dev-01.k8s.masmovil.com/mas-ticketing-api/ticket/73232/attachment/24819/MYSIM_398171_53e82c60-075c-42ab-af94-868ef8b80071.pdf",
"filename": "MYSIM_398171_53e82c60-075c-42ab-af94-868ef8b80071.pdf",
"created": "2022-01-13T09:20:22.556+0000",
"mimeType": "multipart/form-data; charset=UTF-8",
"size": 5576
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
self | string | The URL of the attachment metadata details. | ||
content | string | The URL of the attachment. | ||
filename | string | The name of the attachment file. there is not much more to say | ||
created | string | The datetime the attachment was created. | ||
mimeType | string | The MIME type of the attachment. | ||
size | integer | The size of the attachment. |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X POST 'https://ticketing.sta.masstack.com/v2/ticket/ATC-20923/attachment' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"name": "MYSIM_3847484.pdf",
"data": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxITEhUSEhMVFhUXGBcVFxUVFRUVF...",
"mimeType": "image/jpeg"
}'Get an attachment from a specific ticket. Returns the file directly by default, or a JSON response when base64=true.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Attachment Id
QUERY PARAMETERS
Return attachment metadata and content encoded in base64 instead of the file
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Attachment GET response
{
"ticketId": "ATC-20923",
"name": "MYSIM_398171_53e82c60-075c-42ab-af94-868ef8b80071.pdf",
"attachmentId": "24819",
"base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/...",
"content": "https://jira.example.com/secure/attachment/24819/MYSIM_398171.pdf"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
ticketId | string | Ticket key in `PROJECT-NUMBER` format (e.g. `ATC-20923`). Use the key, not the numeric id (e.g. `937328`) — they are different identifiers. | ||
name | string | Attachment file name | ||
attachmentId | string | Attachment Id | ||
base64 | string | Attachment content in base64 format | ||
content | string | The URL of the attachment content |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/ticket/ATC-20923/attachment/:attachmentId?base64=false' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Delete an attachment
PATH PARAMETERS
Attachment Id
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
No Content No content
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X DELETE 'https://ticketing.sta.masstack.com/v2/attachment/:attachmentId' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Get the rows of a grid custom field for a ticket
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
QUERY PARAMETERS
Custom field name as per mapped from customfield_id's
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Grid rows response
[
{
"key": null
}
]Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923/grid?customFieldName=workorder_index' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Update rows of a grid custom field for a ticket
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
QUERY PARAMETERS
Custom field name as per mapped from customfield_id's
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
Rows and columns to update
[
{
"rowId": "row_94ba7042-c49b-4f53-971b-44549b9c08a0",
"columns": {
"key": null
}
}
]| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
rowId
*
| string | Row identificator of the row to be modified | ||
columns
*
| object | Object containing the names (key value pairs) of the columns to be modified | ||
| object | ||||
No Content No content
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X PUT 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923/grid?customFieldName=workorder_index' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '[
{
"rowId": "row_94ba7042-c49b-4f53-971b-44549b9c08a0",
"columns": {
"key": null
}
}
]'Delete rows of a grid custom field for a ticket
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
Organization name as it is registered in Mas-Stack
QUERY PARAMETERS
Custom field name as per mapped from customfield_id's
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
Identifiers of the rows to delete
[
"row_94ba7042-c49b-4f53-971b-44549b9c08a0"
]No Content No content
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X DELETE 'https://ticketing.sta.masstack.com/v2/orgs/yoigo/ticket/ATC-20923/grid?customFieldName=workorder_index' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '[
"row_94ba7042-c49b-4f53-971b-44549b9c08a0"
]'Available issue links types
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Available issue link types
[
{
"id": "string",
"name": "string",
"inward": "string",
"outward": "string"
}
]| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
id | string | IssueLinkType Id | ||
name | string | IssueLinkType name | ||
inward | string | Issue origin action | ||
outward | string | Issue destination action |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/issueLinkType' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Create IssueLink for specific ticket
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
{
"id": "string",
"type": {
"name": "string",
"id": "string",
"inward": "is blocked by",
"outward": "blocks"
},
"inwardIssue": {
"key": "string"
},
"outwardIssue": {
"key": "string",
"status": "Open",
"ticketType": "Incidencia"
},
"comment": "string"
}| Property | Type | Description | Constraints | Default | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | string | IssueLink Id | |||||||||||||||||||||||||||
type | object | IssueLink type | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
inwardIssue | object | Issue origin reference | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
outwardIssue | object | Issue destination reference | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
comment | string | Comment added to the ticket together with the link | |||||||||||||||||||||||||||
Created issue link created successfully
{
"message": "issue link created successfully."
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
message | string |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X POST 'https://ticketing.sta.masstack.com/v2/issueLink' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"id": "string",
"type": {
"name": "string",
"id": "string",
"inward": "is blocked by",
"outward": "blocks"
},
"inwardIssue": {
"key": "string"
},
"outwardIssue": {
"key": "string",
"status": "Open",
"ticketType": "Incidencia"
},
"comment": "string"
}'Get IssueLink by id
PATH PARAMETERS
issue link id
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Issue Link
{
"id": "string",
"type": {
"name": "string",
"id": "string",
"inward": "is blocked by",
"outward": "blocks"
},
"inwardIssue": {
"key": "string"
},
"outwardIssue": {
"key": "string",
"status": "Open",
"ticketType": "Incidencia"
},
"comment": "string"
}| Property | Type | Description | Constraints | Default | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | string | IssueLink Id | |||||||||||||||||||||||||||
type | object | IssueLink type | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
inwardIssue | object | Issue origin reference | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
outwardIssue | object | Issue destination reference | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
comment | string | Comment added to the ticket together with the link | |||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/issueLink/:issueLinkId' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Delete IssueLink by id
PATH PARAMETERS
issue link id
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
No Content No content
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X DELETE 'https://ticketing.sta.masstack.com/v2/issueLink/:issueLinkId' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Get all remote links attached to a ticket
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Remote links attached to the ticket
[
{
"globalId": "string",
"relationship": "string",
"object": {
"summary": "string",
"title": "string",
"url": "string"
},
"application": {
"name": "string",
"type": "string"
}
}
]| Property | Type | Description | Constraints | Default | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
globalId | string | Global identifier of the remote link | ||||||||||||||||||||||
relationship | string | Relationship between the ticket and the remote object | ||||||||||||||||||||||
object | object | |||||||||||||||||||||||
| ||||||||||||||||||||||||
application | object | |||||||||||||||||||||||
| ||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/remotelink/ATC-20923' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Create a remote link
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
{
"globalId": "string",
"relationship": "string",
"object": {
"summary": "string",
"title": "string",
"url": "string"
},
"application": {
"name": "string",
"type": "string"
}
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
globalId | string | Global identifier of the remote link | ||||||||||||||||||||||
relationship | string | Relationship between the ticket and the remote object | ||||||||||||||||||||||
object | object | |||||||||||||||||||||||
| ||||||||||||||||||||||||
application | object | |||||||||||||||||||||||
| ||||||||||||||||||||||||
Created create a remote link
{
"message": "remote issue link created successfully."
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
message | string |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X POST 'https://ticketing.sta.masstack.com/v2/remotelink/ATC-20923' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"globalId": "string",
"relationship": "string",
"object": {
"summary": "string",
"title": "string",
"url": "string"
},
"application": {
"name": "string",
"type": "string"
}
}'Returns the custom fields mapping for a specific ticketing provider or for all providers if no provider header is specified. The response includes the count of custom fields and detailed metadata objects for each custom field.
Behavior: - If ticketing-provider header is provided: returns custom fields for that specific provider - If ticketing-provider header is omitted: returns custom fields for all providers that support custom fields
Security: requires a valid Bearer JWT token. The token must carry the ticketing-mas.ticketing.access.allowed API access role. mTLS requests (without Authorization header) are also accepted.
HEADER PARAMETERS
Optional. Acronym identifying the ticketing provider. If provided, returns custom fields only for the specified provider. If omitted, returns custom fields for all providers. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Custom fields map response
{
"ticketingProvider": "TGJ",
"customFieldsCount": 45,
"customFieldsObjects": {
"customer_document": {
"id": "customfield_10100",
"name": "Documento Cliente",
"apiName": "customer_document",
"fieldType": "string"
},
"work_order_id": {
"id": "customfield_10101",
"name": "ID Orden de Trabajo",
"apiName": "work_order_id",
"fieldType": "string"
}
}
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
ticketingProvider | string | The ticketing provider acronym | ||
customFieldsCount | integer | Total number of custom fields for this provider | ||
customFieldsObjects | object | Detailed metadata for each custom field | ||
| object | ||||
| Property | Type | Description | Constraints | Default | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
providers | object[] | List of custom fields data for each ticketing provider | |||||||||||||||||||||||||||
Array items:
| |||||||||||||||||||||||||||||
totalProviders | integer | Total number of providers with custom fields | |||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/customfields' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Returns the Jira Insights object map for the specified ticketing provider. The map contains insight objects indexed by their identifier.
Security: requires a valid Bearer JWT token. The token must carry the ticketing-mas.ticketing.access.allowed API access role. mTLS requests (without Authorization header) are also accepted.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Insights map response
{
"size": 42,
"response": {
"1": {
"id": "1",
"name": "Customer Assets",
"objectType": "Customer"
},
"2": {
"id": "2",
"name": "Network Devices",
"objectType": "Infrastructure"
}
}
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
size | integer | Number of insight objects in the map | ||
response | object | Map of insight objects indexed by their identifier | ||
| object | ||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/insights' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Returns the Jira Insights object map with type information for the specified ticketing provider. The map contains insight objects with their associated types indexed by identifier.
Security: requires a valid Bearer JWT token. The token must carry the ticketing-mas.ticketing.access.allowed API access role. mTLS requests (without Authorization header) are also accepted.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK Insights map with types response
{
"size": 42,
"response": {
"1": {
"id": "1",
"name": "Customer Assets",
"objectType": "Customer"
},
"2": {
"id": "2",
"name": "Network Devices",
"objectType": "Infrastructure"
}
}
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
size | integer | Number of insight objects in the map | ||
response | object | Map of insight objects indexed by their identifier | ||
| object | ||||
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/insights/types' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Returns the AI-generated summary for a given ticket without updating the ticket in the ticketing provider. The response includes the operative summary and the message for the client, as generated by the IA service.
Security: requires a valid Bearer JWT token. The token must carry the ticketing-mas.ticketing.access.allowed API access role and the ticketing.ticket.iaSummary operation permission. mTLS requests (without Authorization header) are also accepted.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK IA summary response
{
"operative_summary": "El cliente reporta fallo total de servicio FTTH desde el 12/02. Se ha realizado diagnóstico remoto sin resultado. Técnico desplazado el 14/02, detectó avería en la ONU. Pendiente reposición de equipo.",
"message_for_client": "Estamos trabajando en la resolución de su incidencia. Un técnico ha visitado su domicilio y hemos identificado el problema. Procederemos a la sustitución del equipo en los próximos días."
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
operative_summary | string | AI-generated operative summary of the ticket, describing the current situation and actions taken. | ||
message_for_client | string | AI-generated message intended to be communicated to the client summarising the ticket status. |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/ticket/ATC-20923/ia/summary' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'Returns the AI-predicted estimated resolution date for a given ticket. The prediction is calculated by adding the predicted minutes to the ticket creation date. The response includes the formatted estimated resolution date and the raw estimated minutes. Additionally, the endpoint updates the ticket's estimated_resolution_date custom field asynchronously.
Security: requires a valid Bearer JWT token. The token must carry the ticketing-mas.ticketing.access.allowed API access role and the ticketing.ticket.iaSummary operation permission. mTLS requests (without Authorization header) are also accepted.
PATH PARAMETERS
Ticket **key** in the MasMovil ticketing tool (e.g. `ATC-20923`, `INST-7902`). **Important — key vs. id:** every ticket has two different identifiers that must not be confused: - **key** — alphanumeric reference in `PROJECT-NUMBER` format (e.g. `ATC-20923`). This is the value you must pass in this parameter. - **id** — internal numeric identifier (e.g. `937328`). This is a different field returned in the response body and must NOT be used as a path parameter. Always use the key. Using the numeric id will result in a 404 or an unexpected result.
HEADER PARAMETERS
Acronym identifying the underlying ticketing tool where the tickets are. JAM (Jira Amarillo), TGJ (TGJira), JNEXT (JiraNext), JNODUS (Jira Nodus), OCEANE (Oceane)
OK IA duration prediction response
{
"estimated_resolution_date": "15/04/2026 14:30",
"estimated_minutes": 301766.34
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
estimated_resolution_date | string | AI-predicted estimated resolution date formatted as dd/MM/yyyy HH:mm | ||
estimated_minutes | number (double) | Raw estimated minutes from ticket creation to resolution as predicted by the IA service. |
Bad Request Bad Request
{
"code": "0015",
"status": "BAD_REQUEST",
"message": "Bad Request",
"detailMsg": "detail message about the error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Unauthorized Unauthorized
{
"code": "0003",
"status": "UNAUTHORIZED",
"message": "Unauthorized",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Not Found Not Found
{
"code": "0004",
"status": "NOT_FOUND",
"message": "Not found",
"detailMsg": "Resource not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
Internal Server Error Internal Server Error
{
"code": "0002",
"status": "UNEXPECTED",
"message": "Unexpected Error",
"detailMsg": null
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code | string | Error code number | ||
status | string | Status error | ||
message | string | Error message | ||
detailMsg | string | Message detail |
curl -X GET 'https://ticketing.sta.masstack.com/v2/ticket/ATC-20923/ia/duration' \
-H 'Authorization: Bearer {access-token}' \
-H 'ticketing-provider: JAM' \
-H 'Accept: application/json'