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:
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
Success Response#
List Response#
Error Response#
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 |
| Method | Endpoint | Description |
|---|
| POST | /tools/knowledge-graph/ingest | Ingest project into knowledge graph |
| GET | /tools/knowledge-graph/search | Search entities (?q=&type=&limit=) |
| GET | /tools/knowledge-graph/entity/:id | Get entity details |
| GET | /tools/knowledge-graph/impact/:entityId | Impact analysis (?depth=) |
| GET | /tools/knowledge-graph/stats | Graph statistics |
| Method | Endpoint | Description |
|---|
| POST | /tools/code-review | Run AI code review on a diff |
| Method | Endpoint | Description |
|---|
| POST | /tools/models/route | Route prompt to optimal model |
| GET | /tools/models | List available models |
| Method | Endpoint | Description |
|---|
| POST | /tools/self-healing/analyze | Analyze build failure |
| GET | /tools/self-healing/patterns | List known failure patterns |
| GET | /tools/self-healing/stats | Healing success statistics |
| Method | Endpoint | Description |
|---|
| POST | /tools/memory | Store a memory |
| GET | /tools/memory/search | Search memories (?q=&limit=) |
| DELETE | /tools/memory/:id | Delete a memory |
Tools — Context Optimizer#
| Method | Endpoint | Description |
|---|
| POST | /tools/context/optimize | Compress context semantically |
| Method | Endpoint | Description |
|---|
| POST | /tools/pair/suggest | Get contextual suggestions |
| POST | /tools/pair/session | Start pair session |
| DELETE | /tools/pair/session/:id | End pair session |
| Method | Endpoint | Description |
|---|
| POST | /tools/learning/submit | Submit anonymous pattern |
| GET | /tools/learning/patterns | Get aggregated patterns |
| GET | /tools/learning/stats | Learning statistics |
| Method | Endpoint | Description |
|---|
| POST | /tools/scheduler/plan | Generate execution plan |
| Method | Endpoint | Description |
|---|
| POST | /tools/anomalies/detect | Detect anomalies in metrics |
| GET | /tools/anomalies | List detected anomalies |
| POST | /tools/anomalies/:id/resolve | Resolve anomaly |
| GET | /tools/anomalies/stats | Anomaly statistics |
| Method | Endpoint | Description |
|---|
| POST | /tools/telemetry/spans | Submit trace spans |
| GET | /tools/telemetry/traces | Query traces |
For detailed request/response schemas and examples, see the Tools API reference.
SDKs#
Official SDKs are coming soon:
- JavaScript/TypeScript
- Python
- Go
Example: Invoke an Agent#
Response:
Detailed Documentation#