Base URL
Use your deployed host (for example https://stargit.com) and keep API access scoped by
account/workspace permissions.
Developer Documentation
StarGit Docs & API Guide
Build against StarGit with predictable auth, queue-backed Git operations, and StarBridge-connected execution. This page combines the core documentation, integration patterns, and public API endpoint examples in one place.
Auth0-first with optional native auth
Queue and polling execution model
Multi-server agent orchestration
Authentication
Use bearer tokens for authenticated endpoints. Production deployments should keep token issuance and secret management server-side.
Execution Model
Action requests are enqueued and executed through StarBridge polling. Design clients for async completion and status refresh.
Documentation Reference
Start with the core integration flows below. Expand each section for request examples and expected behavior.
Register your app or service identity, then use the returned credentials/token in authenticated requests.
curl -X POST https://stargit.com/api/register \
-H "Authorization: Bearer YOUR_TOKEN"StarGit uses OAuth2-style token flows for API access. Exchange your app credentials for an access token:
curl -X POST https://stargit.com/api/authenticate \
-d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"Core endpoint families used by typical integrations:
- GET /api/users - Retrieve a list of users.
- POST /api/users - Create a new user.
- GET /api/projects - Get project information.
For self-hosted deployments, replace stargit.com with your own StarGit domain.
API Endpoints
Featured endpoint examples for synchronization, AI workflows, security checks, and deployment automation. This brings the most useful public API cards directly into Docs.
Automated Sync
Automatically synchronize project files across repositories and environments.
POST /api/sync/automatedcurl -X POST https://stargit.com/api/sync/automated \
-d '{"project_id":"123","sync_type":"full"}'Multi-Project Sync
Synchronize multiple projects with one request.
POST /api/sync/multicurl -X POST https://stargit.com/api/sync/multi \
-d '{"project_ids":["123","456"],"sync_type":"incremental"}'AI-Assisted Commit
Generate commit messages from repository changes with AI assistance.
POST /api/commit/aicurl -X POST https://stargit.com/api/commit/ai \
-d '{"project_id":"123","changes":"Refactored core logic"}'AI Security Alerts
Retrieve AI-generated security alerts for project codebases.
GET /api/security/alertscurl https://stargit.com/api/security/alerts?project_id=123Automated Deployment
Trigger deployment to staging or production environments.
POST /api/deploycurl -X POST https://stargit.com/api/deploy \
-d '{"project_id":"123","env":"production"}'Auto Pull Updates
Pull latest repository updates through remote orchestration.
POST /api/pull/autocurl -X POST https://stargit.com/api/pull/auto \
-d '{"project_id":"123"}'Auto Daily Commit
Enforce daily commit policies with automated commit flows.
POST /api/commit/dailycurl -X POST https://stargit.com/api/commit/daily \
-d '{"project_id":"123"}'Blockchain Publish
Publish commit metadata to blockchain for immutable traceability.
POST /api/blockchain/publishcurl -X POST https://stargit.com/api/blockchain/publish \
-d '{"project_id":"123"}'Pipeline Trigger
Trigger build, test, and deploy pipeline actions programmatically.
POST /api/pipeline/triggercurl -X POST https://stargit.com/api/pipeline/trigger \
-d '{"project_id":"123","action":"build"}'Notifications
Dispatch notification events to configured recipients and channels.
POST /api/notificationscurl -X POST https://stargit.com/api/notifications \
-d '{"project_id":"123","event":"deploy","recipient":"you@example.com"}'