GET
/healthzHealth check
Returns service health for the API container.
Driftstone API
Documentation
Driftstone is the Git system for agent workspaces. It exposes a small v1 API for creating repositories, branching work, reading and writing files, merging changes, and syncing branch state.
Base URL
https://api.driftstone.aiVersion prefix
/v1Repositories
Branches
Contents
Merge + Sync
Start
Authentication
Send an organization API key on every versioned API request. Authorization must be passed in the request headers. API keys are expected to start with dk-.
Authorization: Bearer dk-...Start
Response format
API responses use a consistent envelope. Successful responses include success: true and a data object. Failed requests include success: false and an error message.
Success
{
"success": true,
"data": {}
}Error
{
"success": false,
"error": "message"
}Start
Health
Health checks do not require bearer authentication and can be used by uptime checks or container probes.
Start
Build flow
Create a repository, branch for isolated work, write changed files, then merge or sync reviewed changes into target branches.
Create repository
Create branch
Write files
Merge or sync
Contents