Documentation Index
Fetch the complete documentation index at: https://bytestream.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Base URL:
All endpoints require Authorization: Bearer sk_atoll_... unless noted.
Organizations
| Method | Endpoint | Description |
|---|
GET | /api/orgs | List your organizations |
POST | /api/orgs | Create an organization |
GET | /api/orgs/{id} | Get organization details |
PATCH | /api/orgs/{id} | Update organization |
DELETE | /api/orgs/{id} | Delete organization |
Projects
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/projects | List visible projects |
POST | /api/orgs/{id}/projects | Create project |
GET | /api/orgs/{id}/projects/{projectId} | Get project with issues |
PATCH | /api/orgs/{id}/projects/{projectId} | Update project |
DELETE | /api/orgs/{id}/projects/{projectId} | Delete project |
POST | /api/orgs/{id}/projects/{projectId}/archive-by-status | Archive issues by status |
GET | /api/orgs/{id}/project-health | Latest health status per project |
Project access
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/projects/{projectId}/members | List project members |
POST | /api/orgs/{id}/projects/{projectId}/members | Add project member |
PATCH | /api/orgs/{id}/projects/{projectId}/members | Update project access |
DELETE | /api/orgs/{id}/projects/{projectId}/members?memberId=... | Remove project member |
GET | /api/orgs/{id}/projects/{projectId}/teams | List project teams |
POST | /api/orgs/{id}/projects/{projectId}/teams | Add team to project |
DELETE | /api/orgs/{id}/projects/{projectId}/teams?teamId=... | Remove team from project |
Issues
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/issues | List issues |
POST | /api/orgs/{id}/issues | Create issue |
GET | /api/orgs/{id}/issues/{issueId} | Get issue detail |
PATCH | /api/orgs/{id}/issues/{issueId} | Update issue |
DELETE | /api/orgs/{id}/issues/{issueId} | Permanently delete issue, owner/admin only |
POST | /api/orgs/{id}/issues/{issueId}/archive | Archive issue |
DELETE | /api/orgs/{id}/issues/{issueId}/archive | Unarchive issue |
POST | /api/orgs/{id}/issues/bulk | Bulk create issues, max 50 |
GET | /api/orgs/{id}/issues/search?q=... | Search issues by title/description |
GET | /api/orgs/{id}/issues/{issueId}/activity | Issue activity feed |
GET | /api/orgs/{id}/issues/{issueId}/pr-links | Linked pull requests |
status, priority, projectId, assigneeId, teamId, milestoneId, q, includeArchived, orderBy, orderDir, limit, and offset.
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/issues/{issueId}/comments | List comments |
POST | /api/orgs/{id}/issues/{issueId}/comments | Add comment |
PATCH | /api/orgs/{id}/issues/{issueId}/comments/{commentId} | Edit comment |
DELETE | /api/orgs/{id}/issues/{issueId}/comments/{commentId} | Delete comment |
GET | /api/orgs/{id}/issues/{issueId}/subtasks | List subtasks |
POST | /api/orgs/{id}/issues/{issueId}/subtasks | Create subtask |
PATCH | /api/orgs/{id}/issues/{issueId}/subtasks/{subtaskId} | Update subtask |
DELETE | /api/orgs/{id}/issues/{issueId}/subtasks/{subtaskId} | Delete subtask |
GET | /api/orgs/{id}/issues/{issueId}/dependencies | List dependencies |
POST | /api/orgs/{id}/issues/{issueId}/dependencies | Add dependency |
DELETE | /api/orgs/{id}/issues/{issueId}/dependencies/{dependencyId} | Remove dependency |
GET | /api/orgs/{id}/labels | List org labels |
POST | /api/orgs/{id}/labels | Create label |
POST | /api/orgs/{id}/issues/{issueId}/labels | Add label to issue |
DELETE | /api/orgs/{id}/issues/{issueId}/labels/{labelId} | Remove label from issue |
GET | /api/orgs/{id}/issues/{issueId}/attachments | List attachments |
POST | /api/orgs/{id}/issues/{issueId}/attachments | Upload attachment |
DELETE | /api/orgs/{id}/issues/{issueId}/attachments/{attachmentId} | Delete attachment |
Milestones
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/projects/{projectId}/milestones | List project milestones |
POST | /api/orgs/{id}/projects/{projectId}/milestones | Create milestone |
GET | /api/orgs/{id}/milestones/{milestoneId} | Get milestone |
PATCH | /api/orgs/{id}/milestones/{milestoneId} | Update milestone |
DELETE | /api/orgs/{id}/milestones/{milestoneId} | Delete milestone |
Goals, KPIs, and initiatives
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/goals | List goals |
POST | /api/orgs/{id}/goals | Create goal |
GET | /api/orgs/{id}/goals/{goalId} | Get goal |
PATCH | /api/orgs/{id}/goals/{goalId} | Update goal |
DELETE | /api/orgs/{id}/goals/{goalId} | Delete goal, owner/admin only |
GET | /api/orgs/{id}/kpis | List KPIs |
POST | /api/orgs/{id}/kpis | Create KPI |
GET | /api/orgs/{id}/kpis/{kpiId} | Get KPI |
PATCH | /api/orgs/{id}/kpis/{kpiId} | Update KPI |
DELETE | /api/orgs/{id}/kpis/{kpiId} | Delete KPI, owner/admin only |
GET | /api/orgs/{id}/kpis/{kpiId}/snapshots | List KPI snapshots |
POST | /api/orgs/{id}/kpis/{kpiId}/snapshots | Record KPI snapshot |
GET | /api/orgs/{id}/initiatives | List initiatives |
POST | /api/orgs/{id}/initiatives | Create initiative |
GET | /api/orgs/{id}/initiatives/{initiativeId} | Get initiative |
PATCH | /api/orgs/{id}/initiatives/{initiativeId} | Update initiative |
DELETE | /api/orgs/{id}/initiatives/{initiativeId} | Delete initiative, owner/admin only |
POST | /api/orgs/{id}/initiatives/{initiativeId}/projects | Add project to initiative |
DELETE | /api/orgs/{id}/initiatives/{initiativeId}/projects | Remove project from initiative |
GET | /api/orgs/{id}/initiatives/{initiativeId}/kpi-impacts | List KPI impact links |
POST | /api/orgs/{id}/initiatives/{initiativeId}/kpi-impacts | Add KPI impact link |
DELETE | /api/orgs/{id}/initiatives/{initiativeId}/kpi-impacts/{impactId} | Remove KPI impact link |
GET | /api/orgs/{id}/initiatives/{initiativeId}/issues | List linked issues |
POST | /api/orgs/{id}/initiatives/{initiativeId}/issues | Link issue |
DELETE | /api/orgs/{id}/initiatives/{initiativeId}/issues/{issueId} | Unlink issue |
GET | /api/orgs/{id}/initiatives/{initiativeId}/milestones | List linked milestones |
POST | /api/orgs/{id}/initiatives/{initiativeId}/milestones | Link milestone |
DELETE | /api/orgs/{id}/initiatives/{initiativeId}/milestones/{milestoneId} | Unlink milestone |
GET | /api/orgs/{id}/heartbeat | Agent heartbeat context |
Members, teams, agents, and integrations
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/members | List members |
POST | /api/orgs/{id}/members | Invite human member |
PATCH | /api/orgs/{id}/members/{memberId} | Update member |
DELETE | /api/orgs/{id}/members/{memberId} | Remove member |
GET | /api/orgs/{id}/profile | Get current member record |
POST | /api/orgs/{id}/members/{memberId}/avatar | Upload avatar |
DELETE | /api/orgs/{id}/members/{memberId}/avatar | Remove avatar |
GET | /api/orgs/{id}/teams | List teams |
POST | /api/orgs/{id}/teams | Create team |
PATCH | /api/orgs/{id}/teams/{teamId} | Update team |
DELETE | /api/orgs/{id}/teams/{teamId} | Delete team |
GET | /api/orgs/{id}/teams/{teamId}/members | List team members |
POST | /api/orgs/{id}/teams/{teamId}/members | Add member to team |
DELETE | /api/orgs/{id}/teams/{teamId}/members/{memberId} | Remove member from team |
GET | /api/orgs/{id}/agents | List agents, owner/admin |
POST | /api/orgs/{id}/agents | Create agent |
DELETE | /api/orgs/{id}/agents/{agentId} | Revoke agent |
GET | /api/orgs/{id}/agents/{agentId}/keys | List agent keys |
POST | /api/orgs/{id}/agents/{agentId}/keys | Generate agent key |
DELETE | /api/orgs/{id}/agents/{agentId}/keys/{keyId} | Revoke agent key |
POST | /api/orgs/{id}/agents/{agentId}/rotate | Rotate all agent keys |
POST | /api/orgs/{id}/agents/{agentId}/install-snippets | Generate agent install snippets |
GET | /api/orgs/{id}/integrations | List integrations, owner/admin |
POST | /api/orgs/{id}/integrations | Create integration |
DELETE | /api/orgs/{id}/integrations/{integrationId} | Revoke integration |
GET | /api/orgs/{id}/integrations/{integrationId}/keys | List integration keys |
POST | /api/orgs/{id}/integrations/{integrationId}/keys | Generate integration key |
DELETE | /api/orgs/{id}/integrations/{integrationId}/keys/{keyId} | Revoke integration key |
Boards, views, templates, updates, and analytics
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/projects/{projectId}/board-columns | List board columns |
POST | /api/orgs/{id}/projects/{projectId}/board-columns | Create board column |
PATCH | /api/orgs/{id}/projects/{projectId}/board-columns/{columnId} | Update board column |
DELETE | /api/orgs/{id}/projects/{projectId}/board-columns/{columnId} | Delete board column |
PUT | /api/orgs/{id}/projects/{projectId}/board-columns/reorder | Reorder board columns |
GET | /api/orgs/{id}/projects/{projectId}/board-views | List board views |
POST | /api/orgs/{id}/projects/{projectId}/board-views | Create board view |
PATCH | /api/orgs/{id}/projects/{projectId}/board-views/{viewId} | Update board view |
DELETE | /api/orgs/{id}/projects/{projectId}/board-views/{viewId} | Delete board view |
GET | /api/orgs/{id}/projects/{projectId}/custom-views | List custom views |
POST | /api/orgs/{id}/projects/{projectId}/custom-views | Create custom view |
PATCH | /api/orgs/{id}/projects/{projectId}/custom-views/{viewId} | Update custom view |
DELETE | /api/orgs/{id}/projects/{projectId}/custom-views/{viewId} | Delete custom view |
GET | /api/orgs/{id}/templates?projectId=... | List issue templates |
POST | /api/orgs/{id}/templates | Create issue template |
PATCH | /api/orgs/{id}/templates/{templateId} | Update issue template |
DELETE | /api/orgs/{id}/templates/{templateId} | Delete issue template |
GET | /api/orgs/{id}/projects/{projectId}/status-updates | List project status updates |
POST | /api/orgs/{id}/projects/{projectId}/status-updates | Create project status update |
GET | /api/orgs/{id}/analytics?from=...&to=... | Get analytics |
GET | /api/orgs/{id}/activity | Organization activity feed |
Automation, webhooks, billing, and GitHub
| Method | Endpoint | Description |
|---|
GET | /api/orgs/{id}/automation-rules | List automation rules |
POST | /api/orgs/{id}/automation-rules | Create automation rule |
GET | /api/orgs/{id}/automation-rules/{ruleId} | Get automation rule |
PUT | /api/orgs/{id}/automation-rules/{ruleId} | Update automation rule |
DELETE | /api/orgs/{id}/automation-rules/{ruleId} | Delete automation rule |
GET | /api/orgs/{id}/automation-rules/{ruleId}/activity | Rule execution history |
POST | /api/orgs/{id}/automation-rules/{ruleId}/test | Dry-run test |
GET | /api/webhooks?orgId=... | List outbound webhooks |
POST | /api/webhooks?orgId=... | Create outbound webhook |
DELETE | /api/webhooks/{id} | Delete outbound webhook |
GET | /api/webhooks/{id}/deliveries | List webhook deliveries |
POST | /api/webhooks/{id}/redeliver/{deliveryId} | Redeliver webhook delivery |
POST | /api/webhooks/{id}/test | Send webhook test event |
GET | /api/orgs/{id}/billing | Get billing state |
POST | /api/orgs/{id}/billing/checkout | Create Stripe Checkout Session |
POST | /api/orgs/{id}/billing/portal | Create Stripe Billing Portal Session |
GET | /api/orgs/{id}/github-connections | List GitHub connections |
GET | /api/integrations/github/repos | List available repos |
POST | /api/integrations/github/connect | Connect repo |
POST | /api/integrations/github/disconnect | Disconnect repo |
Notifications and public endpoints
| Method | Endpoint | Description |
|---|
GET | /api/notifications | List notifications |
POST | /api/notifications/{id}/read | Mark notification as read |
POST | /api/notifications/read-all | Mark all notifications as read |
GET | /api/health | Health check |
POST | /api/feedback | Public platform feedback endpoint, no auth |
