Skip to main content

​
Overview

These endpoints manage project databases (operations, checkpoints, SQL backups) and dev container access.

​
Trigger AI Indexing

​
POST
/builder/ai/index-trigger
Trigger re-indexing of project files for AI context.
Request Body 
{
  "projectId": "project_abc123"
}

​
Database Operations

​
GET
/builder/database/{projectId}/operations
List active database operations for a project.
Path Parameters
ParameterTypeDescription
projectIdstringThe project’s UUID

​
Database Checkpoints

​
List Checkpoints

​
GET
/builder/database/{projectId}/checkpoints
List all database checkpoints for a project.

​
Restore Checkpoint

​
POST
/builder/database/{projectId}/checkpoints/{hash}/restore
Restore a database to a specific checkpoint.
Path Parameters
ParameterTypeDescription
projectIdstringThe project’s UUID
hashstringThe checkpoint hash

​
SQL Backups

​
List Backups

​
GET
/builder/database/{projectId}/sql-backups
List all SQL backups for a project.

​
Download Backup

​
GET
/builder/database/{projectId}/sql-backups/{s3Key}/download
Download a specific SQL backup file.
Path Parameters
ParameterTypeDescription
projectIdstringThe project’s UUID
s3KeystringThe backup file identifier

​
Terminal

​
WebSocket
/builder/dev-container/{projectId}/terminal
WebSocket connection to the project’s dev container terminal.
This endpoint upgrades to a WebSocket connection for real-time terminal I/O.