Touching Tickets

This method allows you to the update the view state for a ticket as well as receive a list of all users who are currently viewing a ticket.

URL

/api/v2/tickets/touch

Access

This method can only be accessed with a user-token.

Supported Parameters

ticket - the reference for the ticket (required)
update_notifications - mark any outstanding notifications for the given ticket as read (optional)
typing - is the user currently typing an update to the ticket (optional)

Example JSON

{
    "last_updated": "2013-02-21T14:24:14Z",
    "viewers": [
        {
            "id": 3,
            "typing": false,
            "viewed_at": "2013-02-21T14:36:57Z",
            "subscribed": false,
            "user": {
                "id": 2,
                "username": "charlie",
                "first_name": "Charlie",
                "last_name": "Smurthwaite",
                "job_title": null,
                "email_address": {
                    "md5": "c31c54cbe04ce8430db6406dbead441b"
                }
            }
        }
    ]
}