API Change log

2019.09.18

  • fixed: A bug was found where the language detector sometimes did not work when creating tickets through the API in legacy instances that had both KM and CM products in it. This is now fixed. 

2019.09.04

  • We created a new endpoint for the CM API called GET /tickets/<ticketId>/forwards. This endpoint allows you to retrieve tickets that have been forwarded to other agents and also any replies to these forwarded tickets.
  • The GET /tickets/<ticketId>/replies endpoint now returns the "source_info" field containing source-related information (e.g. "cc" and "bcc" information for "mail" source).
  • Going forward, the Case Management App registers the replies to agent forwards in the ticket history.

Released 2019.08.07

  • We added a new API endpoint called GET /settings/metadata. This endpoint allows you to retrieve the metadata of the configured users, agents and tickets (a.k.a extra info).

Released 2019.07.24

  • The POST /tickets-search endpoint now allows you to filter tickets by the date they were archived. Note: This is not retroactive. It only applies to tickets archived from the release of this feature onwards.

Released 2019.07.10

  • A bug was found where automatic emails for the action ASSIGN_TICKET_TO_USER were not working if a ticket was assigned using the API. This is now fixed.

Released 2019.06.26

  •  Fixed: A bug was found where the webhook event was not being sent for “reply&close” ticket action in “external” source tickets. This is now fixed.

Released 2019.06.12

  • You can now retrieve tickets that have a specific classification through the GET /tickets endpoint, using a new "classification" parameter that accepts a comma-separated list of classification IDs.
  • Fixed: A bug was found where tickets with attachments that had badly formatted names threw an error and could not be retrieved from the API. This is now fixed.
  • Fixed: A bug was found in the response format of the timetables, where all work timetable days for the same queue should have been returned in a single object but they were returned in different objects instead. This is now fixed.

Released 2019.05.15

  • All GET /tickets and GET /tickets/<ticketId> calls now return a new "surveys" (yes/no) flag. This flag is to indicate whether or not the end user answered the survey linked to the ticket.
  • You can now edit the language setting of a ticket from the PUT /tickets/<ticketId> endpoint.

Released 2019.04.17

  • The GET /tickets/<ticketId>/history endpoint now also returns ticket forwards (if there are any).
  • Calls to the GET /tickets and GET /tickets/<ticketId> endpoints now return a new "source_info" field. This field contains relevant information about the source of the ticket, e.g. the "to" and "cc" fields for emails. 

Released 2019.03.20

  • When performing a request to update the data of a ticket data (PUT /tickets/:ticketId), the API always returned a successful response even when the field provided in the request payload was not valid. This did not cause any malformation of the data but it could lead to misunderstanding the response. This is now fixed.
  • We enabled the PUT /users/<userId> endpoint to be used with domain key authentication. This allows you to call it from any client-side integration. 
  • We enabled the GET /queues endpoint to be used with domain key authentication, only if it is called with the "name" parameter. This allows an integration to retrieve the information of a queue if you know its name.
  • We created a new /tickets/:ticketId/surveys endpoint to allow integrations to retrieve the user responses to surveys linked to a ticket. 

Released 2019.03.06

  • We created a new /tickets/:ticketId/surveys endpoint to allow integrations to retrieve the user responses to surveys linked to a ticket.

Released 2019.01.23

  • Fixed: Under certain circumstances, when using the API and retrieving a ticket history that contained some inline images, the images had wrong identifiers. All images should now have a correct identifier.
  • When calling /tickets/<id>/replies for a ticket that had a survey answer, an extra message containing some alphanumeric characters was appended to the list of replies. Because this behavior could create confusion, Inbenta corrected it so that this extra message is no longer created.

Released 2018.12.12

  • Added a way to rotate access_token signing key
  • Ticket "last changes" information in API
  • CM API route can now retrieve all the available ticket sources
  • Added IQL querying language documentation 

Released 2018.11.07

  • Fixed: updated one of the library dependencies with a security fix to avoid problems when transitioning to/from Daylight Savings Time.

Released 2018.10.17

  • Fixed: Updating the "extra data" of a ticket when it had not been set previously in Backstage resulted in failure. This is now fixed.

Released 2018.09.05

  • General Performance improvements: Improved the way attachments in tickets are created, loaded and downloaded. This will have a positive effect on the Backstage, specially related to database and overall application speed.

Released 2018.08.22

  • Fixed: The [GET] /classifications endpoint returned an incorrect "breadcrumbs" path. The classifications "tree" should now appear in the correct order.

Released 2018.08.08

  • Fixed: Occasionally the DELETE /queues endpoint was not moving properly all the tickets to another queue. This has been corrected.

Released 2018.07.25

  • Added: A ticket's external_id is returned in all the /tickets endpoints. This id can also be used in GET requests as a filter, to find a ticket by its external_id.

Released 2018.07.11

  • Fixed: Some queries to retrieve tickets from the archive did not work. They do now.
  • Fixed: Minor issues related to sending inline attachments.

Released 2018.06.13

  • Limit access for tokens generated from domain keys. This allows doing client-side (no hosting) integrations, which create tickets without having security issues
  • Add support for inline attachments.
  • Fixed: Make sure the ticket description always returns HTML instead of plain text

Released 2018.05.30

  • Set the ticket creation time as the default value for the last reply time. This allows ordering tickets by last reply having into account the tickets creation date

Released 2018.05.16

  • Fixed: the ticket history endpoint (GET /history) was returning invalid data in some rare cases
  • Added extra parameter validations on [GET] /tickets endpoint to prevent errors

Released 2018.05.02

  • Fixed: minor fixes in response consistency
  • Added new endpoint to retrieve a ticket history ([GET] /tickets/{id}/history)

Released 2018.04.04

  • Fixed: bug that sometimes returned a 500 error instead of a 404 when asking for an non-existent media
  • The language of a ticket will be detected automatically upon creation whenever possible instead of always using the default language