alex
ea174b1642
- Fix duplicate mode field in config_profiles.py mount response - Fix datetime.UTC import for Python 3.10 compatibility - Add API documentation for config profiles - Update CHANGELOG
1.2 KiB
1.2 KiB
API Documentation
Overview
The Headquarter API is a RESTful API built with FastAPI. All endpoints (except auth) require authentication via session cookie.
Base URL
- Development:
http://localhost:8000 - Production:
https://api.yourdomain.com
Authentication
Most endpoints require authentication. Include the session cookie in requests:
curl http://api.example.com/endpoint \
-H "Cookie: session=your_session_cookie"
Response Format
All responses are JSON. Error responses follow this format:
{
"detail": "Error message"
}
API Sections
- Auth - Authentication endpoints
- Projects - Project management
- Repositories - Git repositories and file operations
- Users - User management and settings
- Tool Types - Tool type management
- Config Profiles - Config profile management for tool instances
- SSH Keys - SSH key management
Testing
Interactive API documentation is available at /docs when running the backend:
http://localhost:8000/docs
This provides:
- Interactive endpoint testing
- Request/response schemas
- Authentication via "Authorize" button