brokle-api-routes

What problem does it solve?

This Skill standardizes API endpoint development for Brokle, ensuring consistency, proper authentication, and clear documentation across both SDK and Dashboard routes. It eliminates guesswork and reduces integration errors.

Core Features & Use Cases

• Dual Route Architecture: Guides on implementing both API Key-authenticated SDK routes (/v1/*) and JWT-authenticated Dashboard routes (/api/v1/*).
• Standardized Patterns: Provides templates for handlers, request/response structures, input validation, and error handling.
• OpenAPI Documentation: Explains how to add Swagger/OpenAPI annotations directly in code for clear, auto-generated API documentation.
• Use Case: A developer needs to add a new API endpoint for project management. This skill provides the exact URL structure, request/response patterns, and OpenAPI annotations required, ensuring the API is consistent and well-documented.

Quick Start

I need to create a new API endpoint /api/v1/projects/{id}/members to list project members. Provide the handler template, including input validation and OpenAPI documentation annotations.