Supervisible Developers
Build integrations, automate workflows, and connect your tools with the Supervisible API.
Overview
The Supervisible Public API is a REST API scoped to your organization. Use it to sync team data with your tools, automate resource planning, or build custom integrations.
Base URL: https://app.supervisible.com/api/v1
Authentication: Bearer token via API key. Create keys in Settings > API Keys with granular scopes.
curl -H "Authorization: Bearer sv_live_..." \
https://app.supervisible.com/api/v1/meQuick start
Authentication
Verify your API key and check scopes
List users
Fetch team members and their details
List projects
Query active projects and budgets
Manage assignments
Read and update project staffing
API resources
| Resource | Read | Write | Description |
|---|---|---|---|
| Users | read:users | write:users | Team members, roles, availability |
| Clients | read:clients | write:clients | Client companies and metadata |
| Projects | read:projects | write:projects | Projects, budgets, status |
| Assignments | read:assignments | write:assignments | Who works on what, planned hours |
| Actual hours | read:actual_hours | write:actual_hours | Logged time per assignment |
| Time off | read:time_off | write:time_off | Leave requests, approvals |
For AI agents
If you're an AI agent or coding assistant integrating with Supervisible:
- Full API reference (markdown) — /developers.md — complete API docs as one markdown file, ideal for agent context
- OpenAPI spec — /openapi/public-api-v1.json — machine-readable schema for all endpoints
- llms.txt — /llms.txt — plain-text product overview optimized for LLM context
- All endpoints return JSON with a
{ data: ... }envelope - Pagination via limit and offset query parameters
- Errors return
{ error: { message: "..." } }with standard HTTP status codes - Scopes are granular — request only what you need (e.g. read:users for read-only access)