Zendesk OpenAPI
Is there an Open API spec / Swagger file for Zendesk? I've seen a few threads from a while ago but wondered if there's any updates:
- https://develop.zendesk.com/hc/en-us/community/posts/360028870454/comments/360004529253
-
Hi Jamie! We don't have this yet, but we are rapidly getting to the point where this will be available. We have been on a company-wide project to get all of our documentation into the OpenAPI spec and once that is complete, the work to get this exportable will begin. I'm banging on the drum for this too and I'm very excited that we're finally getting close, so you have internal allies!
-
Hi @... - thanks for the response and excited to hear that! Any chance we could be added to a beta for the openapi spec even if for limited endpoints? At Retool we have a ton of customers using our product with Zendesk for support and operations flows. We'd love to get a partnership going here!
-
I'm not sure if we are opening up any of that in beta, but I will check next week when I meet with that team and I'll let you know after the meeting what I find out!
-
Hi Jamie, I was facing the same issue and decided to do something about that, I have released some basic yaml with endpoints I was using during work.
https://github.com/ItamarBittton/zendesk-openapi
Hopefully you will find that useful :)
-
Hey @...,
Following up on this question, how's the progress on the OpenAPI spec? Is there an EAP available or plans to make one available before a general public release?
Thanks in advance for the info,
Amjad
-
Any further news? Seems very odd for a company of this size not to have an Open API spec...
-
Hi Paul, apologies for the delay on this one, it has been a lot of work getting all of our APIs up and running on this project. We have been working on making the OAS publicly available and I'm not sure what that timeline is looking like. I'm going to reach out to the team responsible for this today and when I hear back, I'll drop an update here for everyone!
-
Gidday Greg, what was that update?
-
Any update? Is there any place we can go to get a partial file?
-
Hi Greg Katechis,
Any news on when your API documentation will be available in the OpenAPI spec? Either publicly, or via a beta/early access programme?
Thanks,
Grant
-
+1. Any chance that work on this has been completed yet? This would definitely help us stay organized and create a clean API layer for Zendesk through our internal systems. Greg Katechis
-
Hi all! Could you take a look at the Postman collection that we have for our APIs and let me know if that will give you what you're looking for?
-
Nope, that won't do for our needs sorry Greg. That documentation is really no more useful than the written documentation provided here. It does not solve the needs of developers who need machine-readable definitions for request and response types, aka DTO (data transfer objects). In other words, we can't use this documentation to generate an SDK, because it doesn't document things as simple as what a "Ticket" object looks like*. There's a reason why people are asking specifically for OpenAPI definitions, because there's already a massive body of open-source tooling built upon it. Conversely, one of the reasons why there's not such a body of open-source tooling built upon Zendesk (such as a stable + actively maintained Node/Javascript/Typescript SDK) is because Zendesk does not publish its DTOs in a machine-readable format.
*I am aware that there are "example responses" for the "Show Ticket" request - but demonstrating an instance of a ticket response is not the same as the blueprint/schema of a ticket response. The latter would show *all* possible properties, which one of them are optional/nullable, what type (eg. `string`, `number` etc) they are.
Please sign in to leave a comment.
13 Comments