API Reference
The Hill90 API provides endpoints for agent management, user profiles, and platform health checks.Base URL
Authentication
Most endpoints require a valid JWT bearer token issued by Keycloak. Include it in theAuthorization header:
Endpoint Groups
Health
| Endpoint | Auth | Description |
|---|---|---|
GET /health | None | Service health check |
User
| Endpoint | Auth | Description |
|---|---|---|
GET /me | Bearer | Get current user JWT claims |
GET /profile | Bearer | Get user profile |
PATCH /profile | Bearer | Update display name |
POST /profile/avatar | Bearer | Upload avatar image |
GET /profile/avatar | Bearer | Get avatar image |
DELETE /profile/avatar | Bearer | Delete avatar |
POST /profile/password | Bearer | Change password (not yet implemented) |
Agents
| Endpoint | Auth | Description |
|---|---|---|
GET /agents | Bearer | List agents |
POST /agents | Bearer | Create agent |
GET /agents/{id} | Bearer | Get agent detail |
PUT /agents/{id} | Bearer | Update agent |
DELETE /agents/{id} | Bearer (admin) | Delete agent |
POST /agents/{id}/start | Bearer (admin) | Start agent container |
POST /agents/{id}/stop | Bearer (admin) | Stop agent container |
GET /agents/{id}/status | Bearer | Get agent status |
GET /agents/{id}/logs | Bearer (admin) | Get agent logs (JSON or SSE stream) |