Driftstone Docs
Back to landing

Driftstone API

Documentation

Driftstone is the Git system for agent workspaces. It exposes a small v1 API for creating repositories, branching work, uploading files, downloading live directories, and copying repository state.

Base URL

https://api.driftstone.ai

Version prefix

/v1

Repositories

Branches

Uploads

Downloads

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.

GET/healthz

Health check

Returns service health for the API container.

Start

Build flow

Create a repository, branch for isolated work, write changed files, then download or copy repository directories for the next runtime step.

Create repository

Create branch

Upload files

Download or copy

Contents

Documentation library

Get Started

OverviewAuthentication, response format, pagination, health, and the recommended Driftstone build flow.

SDK

Python SDKInstall and use the Driftstone Python SDK for repositories, uploads, downloads, branches, copies, sync, and extensions.

API Reference

RepositoriesCreate and retrieve Driftstone repositories.Uploads + DownloadsCreate signed URLs for repository files and live directories.BranchesCreate, list, and inspect repository branches.Commits + RollbackList branch commit history and move a branch head back to an existing snapshot.CopiesCopy one repository directory to another and poll copy jobs.SyncMerge one main storage directory into branch state directories.Main DiffsList recorded main changes and resolve combined diff ranges.ValidatorsConfigure validation gates before sync or upload promotion.ExtensionsCreate, update, run, poll, and delete private agent extensions.