Tickets

Operations

Create a Ticket

Request

This method creates a ticket at locations where a user has trouble ticket ordering permission.

Security

BearerAuth

Bodyapplication/json

codestringrequired

Ticket Code.

Enum:"0000-0000""0000-0001""0000-0002""0001-0000""0001-0001""0001-0002""0001-0003""0002-0000""0002-0001""0003-0000"

Example:"0001-0000"

descriptionstring, [ 5 .. 4000 ] charactersrequired

Description of the trouble or issue.

Example:"Description of the trouble or issue"

primaryIdstring, [ 1 .. 100 ] charactersrequired

Primary reference identifier.

Example:"AM0:000:00000"

occurredDateTimestring, (date-time)required

Date and time the issue occurred.

Example:"2020-05-22T19:23:51Z"

secondaryIdstring, [ 1 .. 100 ] characters

Secondary reference identifier

Example:"AM0:000:00000:000"

customerReferenceIdstring, [ 1 .. 40 ] characters

Customer Reference Number / External Reference Number.

Example:"External Reference Number"

attachmentsArray of objects, <= 5 items(Attachment)

File(s) attached to the ticket. e.g. picture of broken device, scanned copy of bill or charge. To learn about including attachments in your request, see POST Attachments API.

contactsArray of any

List of persons who will be contacted for this ticket.

detailsLAYER1_0000_XXXX (object) or NETWORK_0001_XXXX (object) or POWER_0002_XXXX (object) or ENVIRONMENT_0003_XXXX (object) or HARDWARE_0004_XXXX (object) or SECURITY_0005_XXXX (object) or MANAGED_SERVICE_0006_XXXX (object) or SMARTVIEW_0007_XXXX (object) or SMARTKEY_0008XXXX (object) or BILLING_0010XXXX (object) or METROCONNECT_0012_XXXX (object)

Any of:

Details or requirements to support ticket resolution, depending on the trouble category you are facing.

Payload

{
  "code": "0001-0000",
  "description": "Description of the trouble or issue",
  "primaryId": "AM0:000:00000",
  "occurredDateTime": "2020-05-22T19:23:51Z",
  "secondaryId": "AM0:000:00000:000",
  "customerReferenceId": "External Reference Number",
  "attachments": [
    { … }
  ],
  "contacts": [
    { … }
  ],
  "details": {
    "callFromCage": false,
    "availability": "WORK_HOURS",
    "timezone": "America/Los_Angeles",
    "submarineEngineerRequired": false
  }
}

Responses

Created

Headers

Locationstring

Location of a ticket.

Example:"/tickets/1-23232322"

Response

No content