This repository contains API specifications of Slack platform features and APIs.

You'll find OpenAPI specs for the Slack Web API and AsyncAPI specs for the Events API.

Read more about our open specification strategy in this announcement.

• Web API
  • OpenAPI 2.0 spec - covers user and bot user token usage of public Web API methods
• Events API
  • AsyncAPI 1.0 spec - a catalog of JSON schema for basic Events API structure and a handful of detailed event types
  • JSON Schema - covers only the basic event wrapper all event types delivered by Slack

We continue to refine and expand schema and example coverage throughout all of our specifications.

We use a combination of internal metadata, custom scripting, and old fashioned writing-by-hand to produce these specifications. They don't always tell the whole truth and are subject to author and operator error. They are really useful though.

Because our specifications are artifacts of an incredible machine, we cannot accept pull requests for this repo. Please file issues with suggestions or bugs with the spec itself. Feedback about the APIs or features the specs describe should be directed to Slack's developer support team.