API Reference
Every operation in the Colony Cloud Service API, with its request and response schemas.
Most of these operations take a dashboard session. Only /api/cli/* and /mcp accept a connection; see API Tokens & REST API.
Colony Cloud Service API (v0.1.0)
Section titled “Colony Cloud Service API (v0.1.0)”| Verb | Path | Summary | Request Schema | Response Schema |
|---|---|---|---|---|
| GET | /api/account/notification-log | List the notification pointers recorded for the current user in the session org | — | NotificationLogResponse |
| GET | /api/account/notification-routing | Derive what reaches the current user and why: stewardship, bundles and reports | — | NotificationRoutingResponse |
| PUT | /api/account/password | Change the current user password | ChangePasswordRequest | MutationSuccessResponse |
| GET | /api/account/profile | Get the current user profile | — | ProfileResponse |
| PUT | /api/account/profile | Update the current user profile | UpdateProfileRequest | ProfileResponse |
| GET | /api/account/vcs-connections | List VCS connections for the current user | — | VcsConnectionsResponse |
| GET | /api/autonomy/{owner}/{repo} | Get a repository’s autonomy grant (the default grant when none is set) | — | RepoAutonomyResponse |
| PUT | /api/autonomy/{owner}/{repo} | Set a repository’s autonomy grant | RepoAutonomyUpdateRequest | RepoAutonomyUpdateResponse |
| GET | /api/bootstrap | Shell bootstrap: session, orgs, tenants, onboarding, repos and workflows in one response | — | BootstrapResponse |
| GET | /api/cli/bootstrap | Return org, enabled repos, and the pipeline store mode and minimum version for the CLI | — | CliBootstrapResponse |
| GET | /api/cli/issues | List pipeline issues for a repo, optionally filtered by state | — | CliIssueListResponse |
| GET | /api/cli/issues/{number}/why | Return detailed status and recent transition history for a specific issue | — | CliIssueWhy |
| GET | /api/cli/pipeline/overview | Return a full pipeline health snapshot including queue depth, workers, and costs | — | CliPipelineOverview |
| GET | /api/config/models | Return the list of available LLM models and their capability tiers | — | ModelsResponse |
| GET | /api/drafts | List issue drafts for the org | — | DraftsListResponse |
| POST | /api/drafts | Create a new issue draft | CreateDraftRequest | CreateDraftResponse |
| DELETE | /api/drafts/{id} | Delete a draft | — | MutationSuccessResponse |
| GET | /api/drafts/{id} | Get a draft by ID | — | DraftResponse |
| PATCH | /api/drafts/{id} | Update draft fields | DraftUpdateRequest | DraftResponse |
| POST | /api/drafts/{id}/import-plan | Materialize a plan_import draft by importing its stored plan | — | PlanImportResult |
| POST | /api/drafts/{id}/publish | Publish a draft as one item, as its declared cardinality | — | DraftPublishResponse |
| POST | /api/drafts/assist | Run an LLM-powered authoring assist action on a draft body | DraftAssistRequest | DraftAssistResponse |
| POST | /api/drafts/plan-import | Create a plan_import draft holding a parsed plan (materializes nothing) | CreatePlanImportDraftRequest | CreatePlanImportDraftResponse |
| GET | /api/email/unsubscribe | Preview what a signed unsubscribe token will stop; never mutates | — | UnsubscribePreview |
| POST | /api/email/unsubscribe | RFC 8058 one-click unsubscribe; stops the emails the signed token names | — | UnsubscribeResult |
| GET | /api/orgs | List organizations the current user belongs to | — | OrgsListResponse |
| POST | /api/orgs | Create a new organization (Colony staff only) | CreateOrgRequest | CreateOrgResponse |
| DELETE | /api/orgs/{orgId} | Delete an organization | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId} | Get organization details | — | OrgDetailResponse |
| PUT | /api/orgs/{orgId} | Update organization name or slug | UpdateOrgRequest | OrgDetailResponse |
| POST | /api/orgs/{orgId}/assistant/chat | Run an operator assistant turn in a server-held conversation (SSE stream; first event is conversation, except a stream of only an error event when the tools could not be loaded; conversation_title follows when the first exchange is titled) | AssistantChatRequest | text/event-stream |
| DELETE | /api/orgs/{orgId}/assistant/conversations | Delete all of the caller’s Mayor conversations | — | — |
| GET | /api/orgs/{orgId}/assistant/conversations | List the caller’s own Mayor conversations, newest last message first | — | AssistantConversationsResponse |
| DELETE | /api/orgs/{orgId}/assistant/conversations/{id} | Delete one of the caller’s Mayor conversations | — | — |
| GET | /api/orgs/{orgId}/assistant/conversations/{id} | Read one of the caller’s Mayor conversations, rendered for the panel | — | AssistantConversationDetail |
| PUT | /api/orgs/{orgId}/assistant/messages/{messageId}/rating | Rate one of the caller’s Mayor replies, with an optional note and share on a thumbs down | AssistantRatingRequest | AssistantRatingResponse |
| GET | /api/orgs/{orgId}/assistant/usage | Mayor month-to-date use against the org cap and the caller’s use today against their daily limit | — | AssistantUsageResponse |
| GET | /api/orgs/{orgId}/audit-log | Fetch the audit event log for an organization | — | OrgAuditLogResponse |
| GET | /api/orgs/{orgId}/billing | Get billing overview for an organization | — | BillingOverview |
| POST | /api/orgs/{orgId}/billing/customer | Create a Stripe billing customer for an organization | — | CreateBillingCustomerResponse |
| GET | /api/orgs/{orgId}/billing/invoices | List invoices for an organization | — | BillingInvoicesResponse |
| GET | /api/orgs/{orgId}/billing/invoices/{invoiceId} | Get a single invoice by ID | — | BillingInvoice |
| GET | /api/orgs/{orgId}/billing/payment-method | Get the Stripe customer portal URL for managing payment methods | — | CustomerPortalResponse |
| GET | /api/orgs/{orgId}/billing/tenants | List billing tenant subscriptions for an organization | — | BillingTenantsListResponse |
| GET | /api/orgs/{orgId}/billing/tenants/{tenantId} | Get subscription details for a billing tenant | — | TenantSubscription |
| POST | /api/orgs/{orgId}/billing/tenants/{tenantId}/cancel | Cancel a tenant subscription at period end | — | CancelSubscriptionResponse |
| POST | /api/orgs/{orgId}/billing/tenants/{tenantId}/checkout | Create a Stripe checkout session for a tier upgrade | TierTransitionRequest | CheckoutSessionResponse |
| POST | /api/orgs/{orgId}/billing/tenants/{tenantId}/reactivate | Reactivate a canceled tenant subscription | — | ReactivateSubscriptionResponse |
| POST | /api/orgs/{orgId}/billing/tenants/{tenantId}/tier | Change the subscription tier for a tenant | TierTransitionRequest | ChangeTierResponse |
| POST | /api/orgs/{orgId}/billing/tenants/{tenantId}/workers | Set the billed worker count for a tenant subscription | SetBillingWorkerCountRequest | SetWorkerCountResponse |
| DELETE | /api/orgs/{orgId}/chat | Disconnect chat and remove every personal link (tenant administrators) | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/chat | Get the chat connection, link counts and the caller’s own link | — | ChatStatusResponse |
| PUT | /api/orgs/{orgId}/chat/channel | Choose the org channel (tenant administrators) | SetChatChannelRequest | SetChatChannelResponse |
| GET | /api/orgs/{orgId}/chat/channels | List channels the chat bot can post to (tenant administrators) | — | ChatChannelsResponse |
| DELETE | /api/orgs/{orgId}/chat/link | Remove the caller’s own chat link | — | MutationSuccessResponse |
| POST | /api/orgs/{orgId}/chat/link | Start linking the caller’s own chat account | — | ChatLinkResponse |
| POST | /api/orgs/{orgId}/chat/remind | Email unlinked members a reminder to link, at most one per 7 days (tenant administrators) | — | ChatRemindResponse |
| POST | /api/orgs/{orgId}/chat/slack/install | Start the Slack install (tenant administrators) | — | ChatInstallResponse |
| POST | /api/orgs/{orgId}/chat/teams/install | Start the Microsoft Teams connect (tenant administrators) | — | ChatInstallResponse |
| GET | /api/orgs/{orgId}/chat/unlinked | List members with no usable chat link (tenant administrators) | — | ChatUnlinkedResponse |
| GET | /api/orgs/{orgId}/connection-health | Get connection health status for all org integrations | — | OrgConnectionHealthResponse |
| PUT | /api/orgs/{orgId}/connection-policy | Set the absolute lifetime of MCP/CLI connections (tenant administrators) | UpdateConnectionPolicyRequest | UpdateConnectionPolicyResponse |
| GET | /api/orgs/{orgId}/connections | List live MCP/CLI connections (own, or all for tenant administrators; mine=true limits it to the caller’s own) | — | OrgConnectionsResponse |
| DELETE | /api/orgs/{orgId}/connections/{connectionId} | Revoke an MCP/CLI connection (every refresh and access token in its lineage) | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/faults | List the org’s open faults and when each connected tenant was last evaluated | — | FaultLedgerResponse |
| GET | /api/orgs/{orgId}/faults/{faultId} | Read one fault by id, open or resolved, with the viewer abilities for its tenant | — | FaultDetailResponse |
| POST | /api/orgs/{orgId}/faults/{faultId}/acknowledge | Claim custody of a fault; refused with FAULT_TAKEN when another member holds it | — | Fault |
| POST | /api/orgs/{orgId}/faults/{faultId}/hand-off | The custodian hands a fault to another member who can take custody | FaultHandOffRequest | Fault |
| DELETE | /api/orgs/{orgId}/faults/{faultId}/mute | Remove the mute on a fault’s condition; idempotent | — | Fault |
| PUT | /api/orgs/{orgId}/faults/{faultId}/mute | Mute a fault’s condition with a reason; it leaves the owed set but stays detected | FaultMuteRequest | Fault |
| GET | /api/orgs/{orgId}/faults/{faultId}/occurrences | List a fault’s occurrences open at any point in the last 7 days, newest first | — | FaultOccurrencesResponse |
| GET | /api/orgs/{orgId}/faults/{faultId}/people | Members who can take custody of the fault and who can change its daily cost cap | — | FaultPeopleResponse |
| POST | /api/orgs/{orgId}/faults/{faultId}/reading | Ask for a fresh reading of a work-not-moving or dead-lettering fault’s evidence | — | Reading |
| POST | /api/orgs/{orgId}/faults/{faultId}/release | The custodian lets a fault go, so it is owed again | — | Fault |
| POST | /api/orgs/{orgId}/faults/{faultId}/retry | Retry a fault’s stranded items, each through its own gate | — | FaultRetryResponse |
| GET | /api/orgs/{orgId}/faults/{faultId}/timeline | A fault’s timeline: raised, each audit row targeting it, then resolved | — | FaultTimelineResponse |
| GET | /api/orgs/{orgId}/faults/{faultId}/told | Who has been told about the fault, by ladder rung | — | FaultToldResponse |
| GET | /api/orgs/{orgId}/installations | List GitHub App installations for an organization | — | InstallationsResponse |
| DELETE | /api/orgs/{orgId}/installations/{appType} | Remove a GitHub App installation from an organization | — | MutationSuccessResponse |
| POST | /api/orgs/{orgId}/installations/{appType}/connect | Get the GitHub App installation connect URL | — | ConnectInstallationUrlResponse |
| GET | /api/orgs/{orgId}/installations/connectable | Pre-flight: diff the orgs the caller administers on GitHub against orgs already connected | — | ConnectableOrgsResponse |
| POST | /api/orgs/{orgId}/installations/refresh | Refresh and reconcile GitHub App installations | — | RefreshInstallationsResponse |
| GET | /api/orgs/{orgId}/invitations | List pending invitations for an organization | — | InvitationsResponse |
| POST | /api/orgs/{orgId}/invitations | Invite a user to an organization | CreateInvitationRequest | CreateInvitationResponse |
| DELETE | /api/orgs/{orgId}/invitations/{id} | Revoke an org invitation | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/mayor-model-route | Whether the Mayor runs on the tenant’s own model access: on or off, provider, the reason it is unavailable and the model it would request | — | MayorModelRouteState |
| PUT | /api/orgs/{orgId}/mayor-model-route | Turn the Mayor’s tenant model route on or off; turning it on runs a live check through the route | UpdateMayorModelRouteRequest | UpdateMayorModelRouteResponse |
| GET | /api/orgs/{orgId}/members | List members of an organization | — | OrgMembersResponse |
| DELETE | /api/orgs/{orgId}/members/{userId} | Remove a member from an organization | — | MutationSuccessResponse |
| PUT | /api/orgs/{orgId}/members/{userId} | Update the role of an org member | UpdateMemberRoleRequest | MutationSuccessResponse |
| POST | /api/orgs/{orgId}/members/{userId}/reinstate | Reinstate a suspended member | — | MutationSuccessResponse |
| POST | /api/orgs/{orgId}/members/{userId}/sign-out | Sign a member out of every session (bumps the member’s session epoch) | — | MutationSuccessResponse |
| POST | /api/orgs/{orgId}/members/{userId}/suspend | Suspend a member: refuse their access while keeping their grants | SuspendMemberRequest | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/onboarding | Get the onboarding checklist status for an organization | — | OnboardingStatusResponse |
| POST | /api/orgs/{orgId}/onboarding/dismiss | Dismiss the onboarding checklist for an organization | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/patience | The patience numbers at the tenant or repository level, with their sources | — | PatienceResponse |
| PUT | /api/orgs/{orgId}/patience | Set or clear patience numbers at the tenant or repository level | PatienceUpdateRequest | PatienceResponse |
| POST | /api/orgs/{orgId}/pipeline/adopt | Adopt an existing Pipeline Store tenant into the organization | AdoptTenantRequest | AdoptTenantResponse |
| GET | /api/orgs/{orgId}/pipeline/config | Get the pipeline configuration for an organization | — | PipelineConfigResponse |
| PUT | /api/orgs/{orgId}/pipeline/config | Update the pipeline configuration for an organization | UpdatePipelineConfigRequest | PipelineConfigUpdateResponse |
| GET | /api/orgs/{orgId}/pipeline/discover | Discover existing tenants from the Pipeline Store | — | DiscoverTenantsResponse |
| GET | /api/orgs/{orgId}/report-readers | List the report readers of an organization | — | ReportReadersResponse |
| POST | /api/orgs/{orgId}/report-readers | Invite a report reader by email | InviteReportReaderRequest | InviteReportReaderResponse |
| DELETE | /api/orgs/{orgId}/report-readers/{userId} | Remove a report reader and sign them out | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/report-readers/invitations | List pending report-reader invitations | — | PendingReportReaderInvitationsResponse |
| DELETE | /api/orgs/{orgId}/report-readers/invitations/{id} | Revoke a pending report-reader invitation | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/repos | List repositories available to the organization | — | OrgReposResponse |
| PUT | /api/orgs/{orgId}/repos/{externalRepoId} | Enable or disable a repository for the pipeline | EnableRepoRequest | EnableRepoResponse |
| GET | /api/orgs/{orgId}/secrets | List configured secrets for an organization | — | OrgSecretsResponse |
| PUT | /api/orgs/{orgId}/secrets | Set or update an org secret | SetSecretRequest | MutationSuccessResponse |
| DELETE | /api/orgs/{orgId}/secrets/{key} | Delete an org secret | — | MutationSuccessResponse |
| POST | /api/orgs/{orgId}/secrets/check | Live-check a model API key without storing it, or the stored key when value is omitted | CheckSecretRequest | CheckSecretResponse |
| GET | /api/orgs/{orgId}/standards-sets | List an organization’s standards sets, each with its latest published version | — | StandardsSetsResponse |
| POST | /api/orgs/{orgId}/standards-sets | Create a named standards set with an initial draft version | CreateStandardsSetRequest | StandardsSetDetail |
| GET | /api/orgs/{orgId}/standards-sets/{setId} | Get a standards set, its versions, and its draft (or latest published) standards | — | StandardsSetDetail |
| POST | /api/orgs/{orgId}/standards-sets/{setId}/checks/{checkName}/promote | Promote a check to blocking, publish, and sweep subscribed repos’ review checks | — | PromoteStandardsCheckResponse |
| GET | /api/orgs/{orgId}/standards-sets/{setId}/exceptions | List every repo’s recorded exception against the set’s checks | — | StandardsExceptionsResponse |
| POST | /api/orgs/{orgId}/standards-sets/{setId}/publish | Publish the draft version as MAX(version)+1 and open a new draft cloned from it | — | StandardsSetDetail |
| POST | /api/orgs/{orgId}/standards-sets/{setId}/standards | Create a standard in the set’s current draft version | CreateStandardRequest | Standard |
| PUT | /api/orgs/{orgId}/standards-sets/{setId}/standards/{standardId} | Update a standard in the set’s current draft version | UpdateStandardRequest | Standard |
| GET | /api/orgs/{orgId}/tenants | List GitHub org tenants associated with this organization | — | OrgTenantsResponse |
| GET | /api/orgs/{orgId}/tenants/{externalOrgId}/daily-cost-cap | A tenant’s daily cost cap: the stored value, the effective value and any active raise | — | DailyCostCapState |
| PUT | /api/orgs/{orgId}/tenants/{externalOrgId}/daily-cost-cap | Set a tenant’s standing daily cost cap, or raise it for today, with a recorded reason | DailyCostCapRequest | DailyCostCapResponse |
| GET | /api/orgs/{orgId}/tenants/{tenantId}/entitlements | Get feature entitlements for a tenant subscription tier | — | Entitlements |
| GET | /api/orgs/{orgId}/webhooks | List outbound webhooks for an organization | — | OrgWebhookListResponse |
| POST | /api/orgs/{orgId}/webhooks | Create an outbound webhook for an organization | CreateWebhookRequest | CreateWebhookResponse |
| DELETE | /api/orgs/{orgId}/webhooks/{id} | Delete an outbound webhook | — | MutationSuccessResponse |
| PATCH | /api/orgs/{orgId}/webhooks/{id} | Update an outbound webhook | UpdateWebhookRequest | UpdateWebhookResponse |
| GET | /api/orgs/{orgId}/webhooks/{id}/deliveries | List delivery attempts for a webhook | — | WebhookDeliveriesResponse |
| POST | /api/orgs/{orgId}/webhooks/{id}/deliveries/{deliveryId}/replay | Replay a failed webhook delivery | — | WebhookDeliveryIdResponse |
| POST | /api/orgs/{orgId}/webhooks/{id}/test | Send a test delivery to a webhook | — | WebhookDeliveryIdResponse |
| GET | /api/orgs/{orgId}/worker-pool | Get the tenant-scoped worker pool config and live status | — | WorkerPoolResponse |
| PUT | /api/orgs/{orgId}/worker-pool | Update the tenant-scoped worker pool size | WorkerPoolUpdateRequest | WorkerPoolUpdateResponse |
| GET | /api/orgs/{orgId}/worker-pool/summary | Get the org-wide running and intended worker counts | — | WorkerPoolSummaryResponse |
| GET | /api/orgs/{orgId}/worker-tokens | List worker registration tokens for an organization | — | WorkerTokensResponse |
| POST | /api/orgs/{orgId}/worker-tokens | Create a worker registration token | CreateWorkerTokenRequest | CreateWorkerTokenResponse |
| DELETE | /api/orgs/{orgId}/worker-tokens/{id} | Revoke a worker registration token | — | MutationSuccessResponse |
| GET | /api/orgs/{orgId}/workers | List workers registered to an organization | — | OrgWorkersResponse |
| PATCH | /api/orgs/{orgId}/workers/{id} | Update worker display name | UpdateWorkerRequest | MutationSuccessResponse |
| POST | /api/orgs/{orgId}/workers/{workerId}/drain | Enqueue a drain command for a worker | — | WorkerDrainResponse |
| POST | /api/orgs/{orgId}/workers/{workerId}/reclaim | Reclaim an in-flight task from a worker | — | WorkerReclaimResponse |
| GET | /api/orgs/{orgId}/workers/floor | Get the worker floor view with heartbeat and queue data | — | WorkerFloorResponse |
| GET | /api/orgs/{orgId}/workers/llm-health | Get LLM health status across all org workers | — | FleetLlmHealthResponse |
| GET | /api/proposals | List proposals (authored, MCP, and plan-import drafts) for the org, with provenance | — | ProposalsListResponse |
| POST | /api/proposals/authorize | Authorize a selection of proposals sequentially; 201 when all are authorized, 207 otherwise | AuthorizeSelectionRequest | AuthorizeSelectionResponse |
| GET | /api/repo-groups | List a tenant’s repository groups in priority order with members | — | RepoGroupListResponse |
| POST | /api/repo-groups | Create a repository group at the lowest priority | RepoGroupCreateRequest | RepoGroup |
| DELETE | /api/repo-groups/{id} | Delete a repository group and compact the remaining ranks | — | RepoGroupDeleteResponse |
| PUT | /api/repo-groups/{id} | Edit a repository group’s name and rules | RepoGroupUpdateRequest | RepoGroup |
| PUT | /api/repo-groups/order | Rewrite the priority order of a tenant’s repository groups | RepoGroupOrderRequest | RepoGroupOrderResponse |
| POST | /api/repo-groups/preview | Preview which repositories join and leave a group under proposed rules | RepoGroupPreviewRequest | RepoGroupPreviewResponse |
| GET | /api/repos | List repos enabled for the org | — | ReposListResponse |
| GET | /api/repos/{owner}/{repo} | Get repo detail and settings | — | RepoDetailResponse |
| GET | /api/repos/{owner}/{repo}/conventions | Get the .colony/conventions.md content for a repo | — | RepoConventionsResponse |
| POST | /api/repos/{owner}/{repo}/conventions/export | Render the repo’s subscribed standards set to markdown and write it to .colony/conventions.md | — | RepoConventionsResponse |
| POST | /api/repos/{owner}/{repo}/conventions/import | Parse the repo’s .colony/conventions.md into standards and import them into the subscribed set’s draft version | — | ImportConventionsResponse |
| GET | /api/repos/{owner}/{repo}/credentials | List package-feed credentials for a repo | — | RepoCredentialsResponse |
| PUT | /api/repos/{owner}/{repo}/credentials | Upsert a package-feed credential for a repo | UpsertRepoCredentialRequest | MutationSuccessResponse |
| DELETE | /api/repos/{owner}/{repo}/credentials/{credentialType} | Delete a package-feed credential for a repo | — | MutationSuccessResponse |
| GET | /api/repos/{owner}/{repo}/credentials/{type} | Get full credential detail for a repo (admin only) | — | RepoCredentialDetailResponse |
| PUT | /api/repos/{owner}/{repo}/default-steward | Set the repository’s default stewards (an empty list clears them) | UpdateRepoDefaultStewardRequest | RepoDefaultStewardResponse |
| GET | /api/repos/{owner}/{repo}/env-secrets | List repository env secrets (metadata only, no values) | — | ListRepoEnvSecretsResponse |
| PUT | /api/repos/{owner}/{repo}/env-secrets | Add or replace a repository env secret | PutRepoEnvSecretBody | MutationSuccessResponse |
| DELETE | /api/repos/{owner}/{repo}/env-secrets/{name} | Delete a repository env secret | — | MutationSuccessResponse |
| PUT | /api/repos/{owner}/{repo}/oauth-credentials | Store Claude.ai OAuth credentials for a repo (Colony’s own organization only; 403 CLAUDE_SUBSCRIPTION_NOT_PERMITTED elsewhere) | UpsertRepoOAuthCredentialsRequest | MutationSuccessResponse |
| GET | /api/repos/{owner}/{repo}/oauth-status | Get Claude OAuth token status for a repo | — | OAuthStatusResponse |
| DELETE | /api/repos/{owner}/{repo}/pin | Unpin a repository for the signed-in person (idempotent) | — | RepoPinResponse |
| PUT | /api/repos/{owner}/{repo}/pin | Pin a repository for the signed-in person (idempotent) | — | RepoPinResponse |
| GET | /api/repos/{owner}/{repo}/secrets | List configured repo secrets (metadata only, no values) | — | RepoSecretsStatusResponse |
| PUT | /api/repos/{owner}/{repo}/secrets | Upsert a named repo secret (Claude OAuth keys only, so Colony’s own organization only; 403 CLAUDE_SUBSCRIPTION_NOT_PERMITTED elsewhere) | UpsertRepoSecretRequest | MutationSuccessResponse |
| DELETE | /api/repos/{owner}/{repo}/secrets/{key} | Delete a named repo secret | — | MutationSuccessResponse |
| PUT | /api/repos/{owner}/{repo}/settings | Update repo pipeline settings (authMode ‘oauth-token’ is Colony’s own organization only; 403 CLAUDE_SUBSCRIPTION_NOT_PERMITTED elsewhere) | UpdateRepoSettingsRequest | UpdateRepoSettingsResponse |
| POST | /api/repos/{owner}/{repo}/settings/inherit | Clear a repository’s own value for a setting so it inherits again | InheritSettingRequest | InheritSettingResponse |
| GET | /api/repos/{owner}/{repo}/si-portfolio/conformance | Compare what the repo’s tracks originated this week with the active portfolio version | — | PortfolioConformanceResponse |
| GET | /api/repos/{owner}/{repo}/si-portfolio/versions | List the self-improvement portfolio versions of a repo | — | PortfolioVersionsResponse |
| POST | /api/repos/{owner}/{repo}/si-portfolio/versions | Create a portfolio draft from the active version or current track values | — | PortfolioVersionResponse |
| DELETE | /api/repos/{owner}/{repo}/si-portfolio/versions/{version} | Delete a portfolio draft | — | MutationSuccessResponse |
| GET | /api/repos/{owner}/{repo}/si-portfolio/versions/{version} | Get a portfolio version with its entries | — | PortfolioVersionResponse |
| POST | /api/repos/{owner}/{repo}/si-portfolio/versions/{version}/activate | Activate a published portfolio version | — | PortfolioVersionResponse |
| PUT | /api/repos/{owner}/{repo}/si-portfolio/versions/{version}/entries | Replace the entries of a portfolio draft | ReplacePortfolioEntriesRequest | PortfolioVersionResponse |
| POST | /api/repos/{owner}/{repo}/si-portfolio/versions/{version}/publish | Publish a portfolio draft (runs nothing until activated) | — | PortfolioVersionResponse |
| POST | /api/repos/{owner}/{repo}/si-portfolio/versions/{version}/template | Mark a published, active or superseded portfolio version as a reusable template | MarkPortfolioTemplateRequest | PortfolioTemplate |
| POST | /api/repos/{owner}/{repo}/si-tracks | Create a self-improvement track for a repo | CreateSITrackRequest | CreateSITrackResponse |
| DELETE | /api/repos/{owner}/{repo}/si-tracks/{trackId} | Delete a self-improvement track | — | MutationSuccessResponse |
| PATCH | /api/repos/{owner}/{repo}/si-tracks/{trackId} | Update a self-improvement track | UpdateSITrackRequest | CreateSITrackResponse |
| PUT | /api/repos/{owner}/{repo}/si-tracks/{trackId}/governance | Declare a self-improvement track governed by the active portfolio or independent | UpdateSITrackGovernanceRequest | CreateSITrackResponse |
| GET | /api/repos/{owner}/{repo}/si-tracks/{trackId}/prompts | List prompt versions for a self-improvement track | — | SIPromptVersionsResponse |
| POST | /api/repos/{owner}/{repo}/si-tracks/{trackId}/prompts | Create a new prompt version for a self-improvement track | CreateSIPromptVersionRequest | CreateSIPromptVersionResponse |
| GET | /api/repos/{owner}/{repo}/si-tracks/{trackId}/prompts/{version} | Get a specific prompt version for a self-improvement track | — | SIPromptVersionResponse |
| POST | /api/repos/{owner}/{repo}/si-tracks/{trackId}/prompts/{version}/activate | Activate a prompt version for a self-improvement track | — | ActivateSIPromptVersionResponse |
| GET | /api/repos/{owner}/{repo}/standards | List the standards from the repo’s subscribed standards set (latest published version) | — | StandardsResponse |
| GET | /api/repos/{owner}/{repo}/standards/exceptions | List the exceptions recorded for the repo against its standards-set checks | — | StandardsExceptionsResponse |
| POST | /api/repos/{owner}/{repo}/standards/exceptions | Record a reasoned exception for an enforced check; the check becomes non-blocking | RecordStandardsExceptionRequest | RecordStandardsExceptionResponse |
| DELETE | /api/repos/{owner}/{repo}/standards/exceptions/{id} | Remove an exception and restore the check to the set’s blocking value | — | MutationSuccessResponse |
| GET | /api/repos/{owner}/{repo}/standards/subscription | Get the repo’s current standards-set subscription and the set it points to | — | RepoSubscriptionResponse |
| PUT | /api/repos/{owner}/{repo}/standards/subscription | Subscribe the repo to an org-level standards set (always-latest, no copy made) | SubscribeRepoRequest | RepoSubscriptionResponse |
| GET | /api/repos/{owner}/{repo}/steward-candidates | List the org members’ linked logins who can steward the repository’s work | — | StewardCandidatesResponse |
| GET | /api/repos/{owner}/{repo}/tracks | List self-improvement tracks for a repo | — | RepoTracksResponse |
| PUT | /api/repos/{owner}/{repo}/tracks/{name} | Enable or disable a self-improvement track | UpdateSITrackEnabledRequest | CreateSITrackResponse |
| POST | /api/repos/{owner}/{repo}/validate-conventions | Validate a draft issue against the repo conventions | ValidateConventionsRequest | ValidateConventionsResponse |
| GET | /api/repos/yours | Up to 8 repositories for the header control: pinned first, then recent activity | — | YourReposResponse |
| GET | /api/reviews | List issues awaiting human review | — | ReviewsListResponse |
| DELETE | /api/settings/bindings/autonomy | Remove a tenant or group value for a Autonomy Settings-tab field | SettingBindingRemoveRequest | SettingBindingRemoveResponse |
| PUT | /api/settings/bindings/autonomy | Set a tenant or group value for a Autonomy Settings-tab field | SettingBindingRequest | SettingBindingSetResponse |
| DELETE | /api/settings/bindings/operations | Remove a tenant or group value for a Operations Settings-tab field | SettingBindingRemoveRequest | SettingBindingRemoveResponse |
| PUT | /api/settings/bindings/operations | Set a tenant or group value for a Operations Settings-tab field | SettingBindingRequest | SettingBindingSetResponse |
| DELETE | /api/settings/bindings/standards | Remove a tenant or group value for a Standards Settings-tab field | SettingBindingRemoveRequest | SettingBindingRemoveResponse |
| PUT | /api/settings/bindings/standards | Set a tenant or group value for a Standards Settings-tab field | SettingBindingRequest | SettingBindingSetResponse |
| GET | /api/settings/inherited | Get a Settings tab’s values with their sources and how many repositories override them | — | InheritedSettingsResponse |
| GET | /api/si-portfolio/templates | List the org’s portfolio templates | — | PortfolioTemplatesResponse |
| DELETE | /api/si-portfolio/templates/{id} | Unmark a portfolio template (seeded drafts and every repo portfolio stay as they are) | — | MutationSuccessResponse |
| POST | /api/si-portfolio/templates/{id}/push | Seed one draft per repo from a template (up to 25; 201 all drafted, 207 otherwise) | PushPortfolioTemplateRequest | PushPortfolioTemplateResponse |
| GET | /api/status/health | Liveness probe — always returns 200 ok with no DB dependency | — | StatusProbeResponse |
| GET | /api/strategy/{owner}/{repo}/charter | Get the active strategy charter for a repository | — | StrategyCharterResponse |
| PUT | /api/strategy/{owner}/{repo}/charter | Create or replace the active strategy charter (ordered goals and guidance); 422 INVALID_GOAL, DUPLICATE_GOAL_ID, UNKNOWN_GOAL_ID or EMPTY_CHARTER | StrategyCharterUpsertRequest | StrategyCharterUpsertResponse |
| GET | /api/strategy/{owner}/{repo}/overview | Strategy overview: goals in charter order with their last 5 assessments, the last outcome and the next run (goals paged) | — | StrategyOverviewResponse |
| GET | /api/strategy/{owner}/{repo}/run-state | Get the strategist’s latest run and whether the repository has an active charter | — | RepoStrategistRunStateResponse |
| GET | /api/strategy/{owner}/{repo}/settings | Get a repository’s strategy settings, next run and last outcome | — | StrategySettingsResponse |
| PUT | /api/strategy/{owner}/{repo}/settings | Update a repository’s strategy settings | StrategySettingsUpdateRequest | StrategySettingsUpdateResponse |
| GET | /api/strategy/{owner}/{repo}/snapshots | List strategy snapshots for a repository, each with its trigger (default: proposed, active, rejected + invalid) | — | StrategySnapshotListResponse |
| GET | /api/strategy/{owner}/{repo}/snapshots/{version} | Get a single strategy snapshot by version | — | StrategySnapshotDetailResponse |
| POST | /api/strategy/{owner}/{repo}/snapshots/{version}/approve | Approve a proposed strategy snapshot and apply it, optionally with whole-array edits; refused edits return 422 with violations | StrategyApproveRequest | StrategyApproveResponse |
| POST | /api/strategy/{owner}/{repo}/snapshots/{version}/reject | Decline a proposed strategy snapshot (a reason is required) | — | StrategyRejectResponse |
| GET | /api/strategy/{owner}/{repo}/snapshots/{version}/review | Review a strategy snapshot: its per-track diff against the live strategy tracks, the operator tracks, the capacity split and the run’s collected inputs | — | StrategyReviewResponse |
| GET | /api/strategy/{owner}/{repo}/snapshots/{version}/transcript | The Strategist run’s transcript for a snapshot, read by the run’s task id | — | StrategyTranscriptResponse |
| POST | /api/strategy/{owner}/{repo}/snapshots/generate | Request an on-demand Strategist run for a repository | — | GenerateStrategyProposalResponse |
| POST | /api/strategy/{owner}/{repo}/snapshots/revert | Re-apply the active strategy snapshot’s parent pool as a new version | — | StrategyRevertResponse |
| GET | /api/strategy/pending-proposals | List repos with pending strategy proposals, their counts and the oldest wait per repo (paged by repo); total sums proposals across all repos | — | StrategyPendingProposalsResponse |
| GET | /health | Return API and database connectivity health status (session required) | — | HealthResponse |
| POST | /mcp | Handle MCP JSON-RPC 2.0 messages (initialize, tools/list, tools/call) | — | McpJsonRpcResponse |
| GET | /pipeline/active-workflows | Return the distinct set of active workflows (by workflowId+version) currently referenced by non-terminal issues | — | ActiveWorkflowsResponse |
| GET | /pipeline/attention | Return list of issues that need operator attention (paged) | — | NeedsAttentionResponse |
| GET | /pipeline/attention-count | Return count of issues that need operator attention | — | AttentionCountResponse |
| GET | /pipeline/attribution | Return cost and work attribution by contributor for a time window | — | PipelineAttributionResponse |
| GET | /pipeline/autonomy | Return autonomy-rate metrics for a time window | — | AutonomyResponse |
| GET | /pipeline/blocked-issues | Return blocked issues with blocking reasons (paged); patterns cover every blocked issue | — | BlockedIssuesResponse |
| GET | /pipeline/budget-overview | Return budget burn rate and exhaustion against the tenant ceiling | — | BudgetOverviewResponse |
| GET | /pipeline/cohort-funnel | Return cohort funnel drop-off analysis for a time window | — | CohortFunnelResponse |
| GET | /pipeline/cost-by-model | Return cost breakdown by LLM model for a time window | — | CostByModelResponse |
| GET | /pipeline/cost-projection | Project monthly LLM spend from throughput and complexity-mix assumptions | — | CostProjectionResponse |
| GET | /pipeline/cost-summary | Return total LLM spend across 24h, 7d, 30d, and lifetime horizons | — | CostSummaryResponse |
| GET | /pipeline/cost-timeseries | Return LLM spend bucketed by hour/day/week/month for an operator-specified range | — | CostTimeseriesResponse |
| GET | /pipeline/dead-letters | Return dead-letter queue entries | — | DeadLettersResponse |
| POST | /pipeline/dead-letters/{id}/resolve | Mark a dead-letter entry as manually resolved | — | MutationSuccessResponse |
| POST | /pipeline/dead-letters/{id}/retry | Re-enqueue a dead-letter entry for retry | — | MutationSuccessResponse |
| POST | /pipeline/dead-letters/resolve-all | Mark every unresolved dead-letter entry for the tenant as resolved | — | DeadLetterResolveAllResponse |
| GET | /pipeline/digest | Return the daily pipeline digest summary | — | DailyDigestResponse |
| GET | /pipeline/events | Return paginated pipeline events with optional filters | — | PipelineEventsResponse |
| GET | /pipeline/events/stream | SSE stream of real-time pipeline state changes | — | text/event-stream |
| GET | /pipeline/findings | Return paginated pipeline findings with optional filters | — | FindingsResponse |
| GET | /pipeline/intelligence/{id} | Return a single intelligence item by ID | — | IntelligenceDetailResponse |
| PATCH | /pipeline/intelligence/{id} | Partial-update operator-editable fields on an intelligence item | UpdateIntelligenceRequest | IntelligenceMutationResponse |
| POST | /pipeline/intelligence/{id}/approve | Approve a candidate/observed/proposed intelligence item | ApproveIntelligenceRequest | IntelligenceMutationResponse |
| POST | /pipeline/intelligence/{id}/dismiss | Dismiss an intelligence item with a required reason | DismissIntelligenceRequest | IntelligenceMutationResponse |
| GET | /pipeline/issues | List active pipeline issues for the org, newest update first, paged | — | PipelineIssuesResponse |
| GET | /pipeline/issues/{issueId}/costs | Return cost breakdown for a pipeline issue | — | IssueCostBreakdownResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number} | Return full detail for a single pipeline issue | — | IssueDetailResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/account | Return a work item’s assembled account: station visits and their attempts | — | WorkItemAccountResponse |
| POST | /pipeline/issues/{owner}/{repo}/{number}/actions | Dispatch an operator action on a pipeline issue | IssueActionRequest | IssueActionResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/comments | Return the comments on a work item’s thread (paged, oldest first) | — | IssueCommentsResponse |
| POST | /pipeline/issues/{owner}/{repo}/{number}/comments | Post a reply on a work item’s thread with the caller’s own VCS credential | CreateIssueCommentRequest | CreateIssueCommentResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/dependency-tree | Return dependency tree for a pipeline issue | — | IssueDependencyTreeResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/events | Return paginated timeline events for a pipeline issue | — | IssueEventsResponse |
| POST | /pipeline/issues/{owner}/{repo}/{number}/invoke-operator-action | Invoke a custom operator action on a pipeline issue | InvokeOperatorActionRequest | InvokeOperatorActionResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/lifecycle-trace | Return the selected lifecycle trace for a pipeline issue, one page of its events; traceId pins the trace across pages | — | LifecycleTraceResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/messages | Return agent messages for a pipeline issue task | — | AgentMessagesResponse |
| POST | /pipeline/issues/{owner}/{repo}/{number}/operator-action | Execute any operator action (framework or custom) via the unified snapshot-driven handler. An Accept may carry expectedHeadSha, followup (followup or no-followup) and note (at most 2000 characters); both apply only to Accept. A pipeline that has not confirmed the Accept yet returns outcome pending. Refusals accept nothing and return 409 with the pipeline’s message: HEAD_MOVED, WRONG_STATE, ITEM_PAUSED, ALREADY_DECIDED, NOTHING_TO_ACCEPT, EPIC_SUBTASK, NOT_EPIC or CODE_HOST_UNAVAILABLE | OperatorActionRequest | InvokeOperatorActionResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/override | Return the states an item’s workflow allows it to move to from its current state | — | OverrideTargetsResponse |
| POST | /pipeline/issues/{owner}/{repo}/{number}/release | Release a parent from a canceled subtask so it stops waiting and can finalize (requires the release grant) | ReleaseSubtaskRequest | ReleaseSubtaskResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/retrospective | Return retrospective analysis for a completed pipeline issue | — | IssueRetrospectiveResponse |
| POST | /pipeline/issues/{owner}/{repo}/{number}/stewardship | Claim, take over or assign a work item’s stewardship with the caller’s own VCS credential | StewardshipRequest | StewardshipResponse |
| GET | /pipeline/issues/{owner}/{repo}/{number}/told | Return who has been told about a work item, and the ladder’s next step | — | WorkItemToldResponse |
| GET | /pipeline/operational-summary | Return operational summary dashboard data | — | OperationalSummaryResponse |
| GET | /pipeline/owed-count | Return count of queue items owed to the viewer, optionally in one repository | — | OwedCountResponse |
| GET | /pipeline/projections | Return GitHub write projections filtered by status (default failed) | — | ProjectionsResponse |
| POST | /pipeline/projections/{id}/discard | Discard a failed or pending GitHub write projection | — | MutationSuccessResponse |
| POST | /pipeline/projections/{id}/retry | Reset a failed GitHub write projection to pending | — | MutationSuccessResponse |
| GET | /pipeline/regression-guard | Return KPI regression guard status across repos, paged by repo | — | RegressionGuardResponse |
| GET | /pipeline/repo-budgets | Return each repo’s budget cap and effective ceiling, with the tenant cap | — | RepoBudgetsResponse |
| GET | /pipeline/reports | Return the sealed report ledger, newest first, including restatements; paged (up to 430 rows per page) | — | ReportLedgerResponse |
| GET | /pipeline/reports/{id} | Return a sealed report by id, byte-identical to the stored payload | — | Report |
| GET | /pipeline/reports/{id}/items | Return a sealed report’s A1 or A5 items as they stood at period close, recomputed from the transition history, with the sealed count | — | ReportItemsResponse |
| GET | /pipeline/reports/{id}/reading | Return Colony’s stored reading of a sealed report, or an unavailable reading when none exists; never calls the model | — | Reading |
| GET | /pipeline/reports/open | Return the live open report for the current period window, recomputed on read | — | OpenReportResponse |
| GET | /pipeline/reports/subscriptions | Return the signed-in user’s report subscriptions for a tenant, ordered day, week, month | — | ReportSubscriptionsResponse |
| DELETE | /pipeline/reports/subscriptions/{period} | Unsubscribe the signed-in user from a tenant period report (idempotent) | — | ReportSubscriptionsResponse |
| PUT | /pipeline/reports/subscriptions/{period} | Subscribe the signed-in user to a tenant period report (idempotent) | — | ReportSubscriptionsResponse |
| GET | /pipeline/repos/{owner}/{repo}/code-map/entities | Return a searchable paginated list of code-map entities for a repo | — | CodeMapEntityListResponse |
| GET | /pipeline/repos/{owner}/{repo}/code-map/entities/{entityId}/relationships | Return inbound and outbound relationships for a code-map entity | — | CodeMapEntityRelationshipsResponse |
| GET | /pipeline/repos/{owner}/{repo}/code-map/scan | Return the latest code-map scan status, entity/relationship counts, and staleness for a repo | — | CodeMapScanStatusResponse |
| GET | /pipeline/repos/{owner}/{repo}/cost-basis | Median cost of the last 20 completed work items in a repository | — | CostBasisResponse |
| POST | /pipeline/repos/{owner}/{repo}/estimate | Request a cost and complexity estimate for a task description | EstimateRequest | EstimateResponse |
| POST | /pipeline/repos/{owner}/{repo}/file-issue | File a new issue into the pipeline via natural-language description | FileIssueRequest | FileIssueResponse |
| GET | /pipeline/repos/{owner}/{repo}/intelligence | Return intelligence items for a repo | — | IntelligenceListResponse |
| GET | /pipeline/repos/{owner}/{repo}/intelligence/retrieve | Retrieve ranked intelligence snippets for an agent role, with optional issue/PR context | — | IntelligenceRetrieveResponse |
| GET | /pipeline/repos/{owner}/{repo}/intelligence/search | Semantic search over intelligence items using pgvector embeddings | — | IntelligenceSearchResponse |
| POST | /pipeline/repos/{owner}/{repo}/knowledge | Add a knowledge item to a repo | AddKnowledgeRequest | AddKnowledgeResponse |
| POST | /pipeline/repos/{owner}/{repo}/plan/import | Import a structured task plan into the pipeline | ImportPlanRequest | PlanImportResult |
| GET | /pipeline/repos/{owner}/{repo}/prs/{prNumber}/review | Return the colony review for a pull request | — | ReviewResponse |
| GET | /pipeline/repos/{owner}/{repo}/retrieval/source-state | Latest persisted retrieval source states (code map, precedent) for a repo | — | RetrievalSourceStatesEntry |
| GET | /pipeline/repos/{owner}/{repo}/retrospectives | Return all retrospectives for a repo | — | RepoRetrospectivesResponse |
| GET | /pipeline/repos/{owner}/{repo}/routed-workflow | Return the workflow an item from this repo routes to by default, plus the workflows its routing rules can send an item to (no predicate evaluated) | — | RoutedWorkflowResponse |
| GET | /pipeline/repos/{owner}/{repo}/workflow-set | Return a repo’s activated workflow set | — | RepoWorkflowSetResponse |
| PUT | /pipeline/repos/{owner}/{repo}/workflow-set | Replace a repo’s activated workflow set (requires the Operations grant) | RepoWorkflowSetSaveRequest | RepoWorkflowSetResponse |
| GET | /pipeline/snapshot | Return per-state issue counts and issue details for all pipeline states. A row in its acceptance action’s target state carries acceptVerdict when a verdict is recorded. A row whose ask is a judgment carries judgement: the deterministic review summary, its tally and the change link | — | SnapshotResponse |
| GET | /pipeline/standards-adoption | Return, per enforced check in a standards set, its blocking flag and how subscribed repos split into failing, clean, excepted and not running | — | StandardsAdoptionResponse |
| GET | /pipeline/state-timeseries | Return state occupancy timeseries for a time window | — | StateTimeseriesResponse |
| GET | /pipeline/stats | Return aggregate pipeline statistics | — | PipelineStatsResponse |
| GET | /pipeline/task-queue | Return the current task queue (paged); summary covers the whole queue, optionally scoped by repo | — | TaskQueueResponse |
| GET | /pipeline/transitions | Return state transition history since a given timestamp | — | TransitionsResponse |
| GET | /pipeline/trends | Return pipeline trend metrics for a time window | — | PipelineTrendsResponse |
| GET | /pipeline/version-skew | Return declared workflow pins, running workflow versions and running worker builds | — | VersionSkewResponse |
| GET | /pipeline/work-items/search | Search work items by number or title across the tenant, all states, newest first | — | WorkItemSearchResponse |
| GET | /pipeline/workflow-definitions | Return workflow definitions for the tenant (paged) | — | WorkflowRegistryResponse |
| POST | /pipeline/workflow-definitions | Register a validated workflow YAML as a new version in the registry (requires the Standards grant) | WorkflowRegisterRequest | WorkflowRegisterResponse |
| GET | /pipeline/workflow-definitions/{workflowId} | Return a specific workflow definition by ID and optional version | — | WorkflowDefinitionDetail |
| POST | /pipeline/workflow-definitions/{workflowId}/activate | Activate a published workflow version on one or more repos of a tenant in one transaction, writing workflow_id and workflow_version together | WorkflowActivateRequest | WorkflowActivateResponse |
| GET | /pipeline/workflow-definitions/{workflowId}/activation-preview | Read-only count of items in flight per repo (judged against each item’s pinned workflow) before activating a version | — | WorkflowActivationPreviewResponse |
| POST | /pipeline/workflow-definitions/validate | Validate a workflow YAML and return structured errors or a preview snapshot | WorkflowValidateRequest | WorkflowValidateResponse |
| DELETE | /pipeline/workflow-drafts | Clear the tenant’s persisted workflow draft | — | WorkflowDraftResponse |
| GET | /pipeline/workflow-drafts | Return the tenant’s single persisted workflow draft, or null if none exists | — | WorkflowDraftResponse |
| PUT | /pipeline/workflow-drafts | Upsert the tenant’s single workflow draft, so it survives closing the editor | WorkflowDraftSaveRequest | WorkflowDraftResponse |
| GET | /pipeline/workflows | Return each enabled repo’s active WorkflowSnapshot keyed by owner/repo | — | WorkflowSnapshotMapResponse |