154c344077
* Fix #2800. Add missing Swagger docs * Add note that timestamps are in miliseconds * Fix merge, update docs. |
||
|---|---|---|
| .. | ||
| docs/html | ||
| README.md | ||
| swagger.yml | ||
Swagger / OpenAPI 2.0 auto-generated files
⚠️ Warning: The API is currently considered Beta and major changes are planned. Please see this note for more details.
This folder is generated by the make swagger command from comments in the server code.
Prerequisites:
These can be installed via Homebrew:
brew tap go-swagger/go-swagger
brew install go-swagger
brew install openapi-generator
Server API documentation
See the generated server API documentation here.
Differences for Mattermost Boards
The auto-generated Swagger API documentation is for Focalboard Personal Server. If you are calling the API on Mattermost Boards, the additional changes are:
API URLs endpoint
The API endpoint is at https://SERVERNAME/plugins/focalboard/api/, e.g. https://community.mattermost.com/plugins/focalboard/api/.
Use the Mattermost auth token
Refer to the Mattermost API documentation here on how to obtain the auth token.
Pass this token as a bearer token to the Boards APIs, e.g.
curl -i -H "X-Requested-With: XMLHttpRequest" -H 'Authorization: Bearer abcdefghijklmnopqrstuvwxyz' https://community.mattermost.com/plugins/focalboard/api/v2/workspaces
Note that the X-Requested-With: XMLHttpRequest header is required to pass the CSRF check.
We want to hear from you!
If you are planning on using the Boards API, we would love to hear about what you'd like to do, and how we can improve the APIs in the future. See here for more details on how to connect.