HTTP API Docs

[jumpy-cat]

• poc test
• add support for post requests
• documentation & examples
• document the existing routes
• test suite
• validate responses option
• announcement in slack and/or main meeting
• new routes?