Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zendesk Tickets API

The Tickets API from Zendesk — 26 operation(s) for tickets.

Zendesk Tickets API is one of 150 APIs that Zendesk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Tickets. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 2 JSON Schemas.

This API exposes 35 operations across 26 paths, and defines 20 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against the base URL https://{subdomain}.zendesk.com.

35 operations 26 paths 20 schemas 6 DELETE15 GET6 POST8 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://{subdomain}.zendesk.com
Resource Areas
1

Paths & Operations 35

Across 26 paths, the API surfaces 35 operations — 6 DELETE, 15 GET, 6 POST, 8 PUT. Each is listed below with its method, path, parameters, and response codes.

Tickets 35
POST
/api/v2/problems/autocomplete
Zendesk Post Api V2 Problems Autocomplete
AutocompleteProblems 1 param body → 200
GET
/api/v2/deleted_tickets
Zendesk Get Api V2 Deletedtickets
ListDeletedTickets 2 params → 200
DELETE
/api/v2/deleted_tickets/{ticket_id}
Zendesk Delete Api V2 Deletedtickets Ticketid
DeleteTicketPermanently 1 param → 200
PUT
/api/v2/deleted_tickets/{ticket_id}/restore
Zendesk Put Api V2 Deletedtickets Ticketid Restore
RestoreDeletedTicket 1 param → 200
DELETE
/api/v2/deleted_tickets/destroy_many
Zendesk Delete Api V2 Deletedtickets Destroymany
BulkPermanentlyDeleteTickets 1 param → 200
PUT
/api/v2/deleted_tickets/restore_many
Zendesk Put Api V2 Deletedtickets Restoremany
BulkRestoreDeletedTickets 1 param → 200
GET
/api/v2/problems
Zendesk Get Api V2 Problems
ListTicketProblems → 200
GET
/api/v2/tickets/{ticket_id}/tags
Zendesk Get Api V2 Tickets Ticketid Tags
ListResourceTags 1 param → 200
POST
/api/v2/tickets/{ticket_id}/tags
Zendesk Post Api V2 Tickets Ticketid Tags
SetTagsTicket 1 param → 201
PUT
/api/v2/tickets/{ticket_id}/tags
Zendesk Put Api V2 Tickets Ticketid Tags
PutTagsTicket 1 param → 200
DELETE
/api/v2/tickets/{ticket_id}/tags
Zendesk Delete Api V2 Tickets Ticketid Tags
DeleteTagsTicket 1 param → 200
GET
/api/v2/tickets
Zendesk Get Api V2 Tickets
ListTickets 1 param → 200
POST
/api/v2/tickets
Zendesk Post Api V2 Tickets
CreateTicket body → 201
GET
/api/v2/tickets/{ticket_id}
Zendesk Get Api V2 Tickets Ticketid
ShowTicket 1 param → 200
PUT
/api/v2/tickets/{ticket_id}
Zendesk Put Api V2 Tickets Ticketid
UpdateTicket 1 param body → 200
DELETE
/api/v2/tickets/{ticket_id}
Zendesk Delete Api V2 Tickets Ticketid
DeleteTicket 1 param → 204
GET
/api/v2/tickets/{ticket_id}/collaborators
Zendesk Get Api V2 Tickets Ticketid Collaborators
ListTicketCollaborators 1 param → 200
GET
/api/v2/tickets/{ticket_id}/email_ccs
Zendesk Get Api V2 Tickets Ticketid Emailccs
ListTicketEmailCCs 1 param → 200
GET
/api/v2/tickets/{ticket_id}/followers
Zendesk Get Api V2 Tickets Ticketid Followers
ListTicketFollowers 1 param → 200
GET
/api/v2/tickets/{ticket_id}/incidents
Zendesk Get Api V2 Tickets Ticketid Incidents
ListTicketIncidents 1 param → 200
PUT
/api/v2/tickets/{ticket_id}/mark_as_spam
Zendesk Put Api V2 Tickets Ticketid Markasspam
MarkTicketAsSpamAndSuspendRequester 1 param → 200
POST
/api/v2/tickets/{ticket_id}/merge
Zendesk Post Api V2 Tickets Ticketid Merge
MergeTicketsIntoTargetTicket 1 param body → 200
GET
/api/v2/tickets/{ticket_id}/related
Zendesk Get Api V2 Tickets Ticketid Related
TicketRelatedInformation 1 param → 200
GET
/api/v2/tickets/count
Zendesk Get Api V2 Tickets Count
CountTickets → 200
POST
/api/v2/tickets/create_many
Zendesk Post Api V2 Tickets Createmany
TicketsCreateMany body → 200
DELETE
/api/v2/tickets/destroy_many
Zendesk Delete Api V2 Tickets Destroymany
BulkDeleteTickets 1 param → 200
PUT
/api/v2/tickets/mark_many_as_spam
Zendesk Put Api V2 Tickets Markmanyasspam
MarkManyTicketsAsSpam 1 param → 200
GET
/api/v2/tickets/show_many
Zendesk Get Api V2 Tickets Showmany
TicketsShowMany 1 param → 200
PUT
/api/v2/tickets/update_many
Zendesk Put Api V2 Tickets Updatemany
TicketsUpdateMany 1 param → 200
GET
/tickets
Zendesk List Tickets
listTickets 5 params → 200401429
POST
/tickets
Zendesk Create Ticket
createTicket body → 201401422429
GET
/tickets/{ticket_id}
Zendesk Show Ticket
getTicket 1 param → 200401404429
PUT
/tickets/{ticket_id}
Zendesk Update Ticket
updateTicket 1 param body → 200401404422429
DELETE
/tickets/{ticket_id}
Zendesk Delete Ticket
deleteTicket 1 param → 204401404429
GET
/tickets/{ticket_id}/comments
Zendesk List Ticket Comments
listTicketComments 4 params → 200401404429

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are Ticket (38 properties), TicketCreate (20 properties), TicketUpdate (15 properties), Comment (10 properties). Each schema is shown below with its type and property counts.

TicketRelatedInformation
object
5 properties
ListDeletedTicketsResponse
object
ListTicketCollaboratorsResponse
object
CustomField
object
A custom field key-value pair.
2 properties
JobStatusResponse
object
1 property
ListTicketEmailCCsResponse
object
TicketResponse
object
1 property
ListTicketProblemsResponse
object
Attachment
object
A file attachment.
6 properties
Via
object
How the ticket or comment was created.
2 properties
TicketCreate
object
Payload for creating a new ticket.
20 properties
Comment
object
A comment on a ticket.
10 properties
TicketsResponse
object
1 property
TicketUpdateResponse
object
2 properties
ListTicketIncidentsResponse
object
ListTicketFollowersResponse
object
TagsByObjectIdResponse
object
1 property 1 required
Error
object
An error response from the Zendesk API.
3 properties
TicketUpdate
object
Payload for updating an existing ticket.
15 properties
Ticket
object
A Zendesk Support ticket representing a customer service request.
38 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zendesk-tickets-api-openapi.yml Raw ↑

Other APIs Zendesk publishes across the network.

Zendesk Help Center Articles API
Zendesk Help Center Sections API
Zendesk Help Center Categories API
Zendesk Help Center Translations API
Zendesk Help Center Article Attachments API
Zendesk Help Center Article Comments API
Zendesk Help Center Article Labels API
Zendesk Help Center Topics API
Zendesk Help Center Posts API
Zendesk Help Center Post Comments API
Zendesk Help Center Votes API
Zendesk Help Center Content Subscriptions API