Steps

The /steps request returns a list of editing steps made on the given Ticket ID. The entries of the list, each being one editing step, contain the basic information about the step. When viewing a primary ticket in a bundle, the response includes merged steps from all tickets in the bundle (primary and secondary tickets).

GET /api/ticket/<ticket-id>/steps

Return a list of editing steps made on the ticket. The list can be reduced by sending the optional URL parameter since, a timestamp that defines the earlier step to be returned. When the ticket is a primary ticket in a bundle, the response includes steps from all tickets in the bundle, merged into a single list.

REQUEST Parameter	Value Type	Description
since	number	An optional timestamp from which on to return the list of editing steps

RESPONSE Fields	Value Type	Description
id	number	The editing step id
actionID	number	The id of the ticket action applied when creating this editing step
userGUID	string	The GUID of the user who applied the ticket action
lastModified	number	The timestamp of the last modification of this editing step
secondaryTicketId	number	The ID of the secondary ticket this step originally belongs to. Only present if this step comes from a bundled secondary ticket (i.e., when viewing a primary ticket with merged steps). If this field is absent, the step belongs to the ticket being viewed.

Example Request

# Request
GET /api/ticket/1/steps HTTP/1.1
Authorization: Bearer VGhpcyBpcyBqdXN0IGEgZGVtbyBhY2Nlc3MgdG9rZW4u
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
[
  {
    "id": 1,
    "actionID": "4",
    "userGUID": "sys02qmoxwlwprnnovhrxtx7n",
    "lastModified": 1234567890
  },
  {
    "id": 2,
    "actionID": "5",
    "userGUID": "sys02qmoxwlwprnnovhrxtx7n",
    "lastModified": 1234567891,
    "secondaryTicketId": 456
  }
  ...
]

Application Example

# Browser access
http://127.0.0.1:9000/api/ticket/1/steps
 
# Shell access using curl
curl -LsH "Authorization: Bearer <access_token>" "http://127.0.0.1:9000/api/ticket/1/steps"
 
# Shell access using curl using username and password
curl -Lsu username:password "http://127.0.0.1:9000/api/ticket/1/steps"