Skip to main content

GitHub, cost, security

GitHub App integration

Controller: GitHubController (api/integrations/github) — JWT (setup callback anonymous)

Used by sessions and agent runs to list installations/repos/branches and clone via the GitHub App.

MethodPathPurpose
GET/statusApp configured?
GET/installationsLinked installations + repos
GET/discoverRelinkable prior installs
POST/linkRelink installation
GET/connectStart GitHub App install
GET/setupAnon callback (installation_id, state)
GET/reposRepos available for agent clone
GET/repos/{owner}/{repo}/branches?installationId=Branches
DELETE/{installationId}/disconnectUnlink

Cost, dashboard & logs

Cost — CostController (api/Cost) — JWT

MethodPathQuery
GET/api/cost/by-request-typeprojectId?, days?
GET/api/cost/by-provideridem
GET/api/cost/by-projectidem
GET/api/cost/by-requestpagination
GET/api/cost/summary

Dashboard — DashboardController (api/Dashboard) — JWT

MethodPathPurpose
GET/api/dashboard/prompt-statsPrompt usage
GET/api/dashboard/token-usageTokens
GET/api/dashboard/provider-statsPer provider
GET/api/dashboard/summaryOverview
GET/api/dashboard/logsLog list
GET/api/dashboard/logs/{id}Log detail

API-key scoped logs also available at GET /api/ai/logs.


Security, AD & health

Security — SecurityController (api/security)

MethodPathAuthPurpose
GET/api/security/statusAdminOnlySecurity mode, audit, CSP, payload writer status
POST/api/security/csp-reportAnonymousBrowser CSP violation reports (204)

Health

curl -s https://your-kroov-host/health
# { "status": "healthy" }