REST API Reference
Bootspring provides a complete REST API for building custom integrations, automating workflows, and programmatic access to all features.
Base URL#
https://api.bootspring.com/api/v1
Authentication#
All API requests require authentication via Bearer token:
Loading code block...
Get your API key from the dashboard.
Rate Limits#
| Tier | Requests/minute |
|---|---|
| Free | 100 |
| Pro | 1,000 |
| Team | 10,000 |
Rate limit headers are included in all responses:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640000000
Response Format#
Success Response#
Loading code block...
List Response#
Loading code block...
Error Response#
Loading code block...
Error Codes#
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid API key |
FORBIDDEN | 403 | Insufficient permissions |
NOT_FOUND | 404 | Resource not found |
VALIDATION_ERROR | 400 | Invalid request data |
RATE_LIMITED | 429 | Too many requests |
SERVER_ERROR | 500 | Internal server error |
Endpoints#
Agents#
| Method | Endpoint | Description |
|---|---|---|
| GET | /agents | List all agents |
| GET | /agents/:id | Get agent details |
| POST | /agents/:id/invoke | Invoke an agent |
Skills#
| Method | Endpoint | Description |
|---|---|---|
| GET | /skills | List all skills |
| GET | /skills/:id | Get skill details |
| POST | /skills/search | Search skills |
| POST | /skills/:id/apply | Apply a skill |
Quality#
| Method | Endpoint | Description |
|---|---|---|
| GET | /quality/gates | List quality gates |
| POST | /quality/run | Run quality check |
| GET | /quality/reports/:id | Get report |
Context#
| Method | Endpoint | Description |
|---|---|---|
| POST | /context/generate | Generate context |
| POST | /context/analyze | Analyze project |
Orchestrator#
| Method | Endpoint | Description |
|---|---|---|
| POST | /orchestrator/analyze | Analyze context |
| POST | /orchestrator/recommend | Get recommendations |
| GET | /orchestrator/workflows | List workflows |
| GET | /orchestrator/workflows/:key | Get workflow details |
| POST | /orchestrator/workflows/:key/start | Start workflow |
| POST | /orchestrator/workflows/advance | Advance workflow |
| POST | /orchestrator/workflows/checkpoint | Mark checkpoint |
| GET | /orchestrator/status | Get status |
MCP#
| Method | Endpoint | Description |
|---|---|---|
| POST | /mcp/tool | Call MCP tool |
| GET | /mcp/resources | List resources |
| GET | /mcp/resource/:uri | Get resource |
Authentication#
| Method | Endpoint | Description |
|---|---|---|
| POST | /auth/login | Authenticate |
| POST | /auth/register | Create account |
| GET | /auth/me | Get current user |
| POST | /auth/refresh | Refresh token |
Todos#
| Method | Endpoint | Description |
|---|---|---|
| GET | /todos | List todos |
| POST | /todos | Create todo |
| PATCH | /todos/:id | Update todo |
| DELETE | /todos/:id | Delete todo |
SDKs#
Official SDKs are coming soon:
- JavaScript/TypeScript
- Python
- Go
Example: Invoke an Agent#
Loading code block...
Response:
Loading code block...