mattermost/api
Nick Misasi 495a49b896
Feature/audit certificate upload (#30223)
* feat: Add certificate upload option for audit logging settings

* Commit current changes

* Additions

* MM-62944 Fix fileupload settings not being clickable

* Support for uploading a cert for experimental audit logging cert. Pre cloud implementation in the backend

* Forgot to add new hook

* Add support for setting custom audit log certifcates in Cloud

* Permissions

* I18n

* Change order

* Linter fixes

* Linter fixes, add openapi spec

* additions for openapi

* More openapi fixes because it won't run locally

* Undo, cursor went rogue

* newline fix

* Align types properly

* Fix i18n

* Fix i18n AGAIN

* Fix error

* Update api/v4/source/audit_logging.yaml

---------

Co-authored-by: Harrison Healey <harrisonmhealey@gmail.com>
Co-authored-by: Mattermost Build <build@mattermost.com>
2025-04-16 09:34:18 -04:00
..
playbooks Move API Reference (#23777) 2023-06-27 11:10:13 -03:00
server Updated API Code Samples (#24141) 2023-08-03 12:45:10 -03:00
v4 Feature/audit certificate upload (#30223) 2025-04-16 09:34:18 -04:00
.gitignore Move API Reference (#23777) 2023-06-27 11:10:13 -03:00
.spectral.yaml Move API Reference (#23777) 2023-06-27 11:10:13 -03:00
CONTRIBUTING.md Move API Reference (#23777) 2023-06-27 11:10:13 -03:00
Makefile Feature/audit certificate upload (#30223) 2025-04-16 09:34:18 -04:00
package-lock.json chore(deps): pin whatwg-url to 12.0.0+ in /api (#27463) 2024-06-27 20:41:58 -03:00
package.json Fix typo in the word repository in api/package.json (#29023) 2024-10-30 18:36:02 -06:00
README.md Move API Reference (#23777) 2023-06-27 11:10:13 -03:00

Mattermost API Documentation

This repository 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

We're accepting pull requests! See something that could be documented better or is missing documentation? Make a PR and we'll gladly accept it.

All the documentation is written in YAML and found in the v4/source directories. APIv4 documentation is in the v4 directory. APIs for Playbooks are retrieved from GitHub at build time and integrated into the final YAML file.

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 v4/html/static/mattermost-openapi-v4.yaml. This will also check syntax using swagger-cli.

To test locally, run make build, make run and navigate to http://127.0.0.1:8080. For any updates to the source files, re-run the same commands.

Deployment

Deployment is handled automatically by our Jenkins CLI machine. When a pull request is merged it will automatically be deployed to https://api.mattermost.com.