Skip to content

Latest commit

 

History

History
27 lines (15 loc) · 2.38 KB

README.md

File metadata and controls

27 lines (15 loc) · 2.38 KB

Mattermost API Documentation

This respository holds the API reference available at https://api.mattermost.com.

The Mattermost API reference uses the OpenAPI standard and the ReDoc document generator.

All documentation is available under the terms of a Creative Commons License.

Contributing

Mattermost API version 4 is an active and in-progress project. We're looking for contributors to code server endpoints, build drivers and write documentation. If you're interested please join our Mattermost instance and join the APIv4 channel.

We're accepting pull requests! Specifically we're looking for documenation on routes defined here.

All the documentation is written in YAML and found in the source directory. APIv3 documentation is in the v3 directory, and APIv4 documentation is in the v4 directory.

There is no strict style guide but please try to follow the example of the existing documentation.

To build the full YAML, run make build and it will be output to html/static/mattermost-openapi.yaml. To check for syntax, you can copy the contents of that into http://editor.swagger.io/ or you can look into using a commandline or ESLint-based syntax checker.

Deployment

Currently, deployment is handled manually and can be done by running make build and deploying the full /html directory to the hosted sited.