API Reference
Projects
Manage projects — the top-level containers that hold databases and configuration.
A project is the top-level container in Silos. It groups databases, holds project-level configuration, and is the scope for usage and operations.
The API is stabilizing. The paths below reflect the current interface; field-level details may still change before general availability.
All project endpoints are served under /v1/projects.
List projects
GET /v1/projects
curl https://api.silos.sh/v1/projects \
-H "Authorization: Bearer $SILOS_API_KEY"{
"projects": [
{
"id": "proj_abc123",
"name": "my-project",
"created_at": "2026-06-01T12:00:00Z"
}
]
}Create a project
POST /v1/projects
curl -X POST https://api.silos.sh/v1/projects \
-H "Authorization: Bearer $SILOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "my-project" }'{
"project": {
"id": "proj_abc123",
"name": "my-project",
"created_at": "2026-06-01T12:00:00Z"
}
}Get a project
GET /v1/projects/{id}
curl https://api.silos.sh/v1/projects/proj_abc123 \
-H "Authorization: Bearer $SILOS_API_KEY"{
"project": {
"id": "proj_abc123",
"name": "my-project",
"created_at": "2026-06-01T12:00:00Z"
}
}Update a project
PATCH /v1/projects/{id}
curl -X PATCH https://api.silos.sh/v1/projects/proj_abc123 \
-H "Authorization: Bearer $SILOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "renamed-project" }'{
"project": {
"id": "proj_abc123",
"name": "renamed-project",
"created_at": "2026-06-01T12:00:00Z"
}
}Delete a project
DELETE /v1/projects/{id}
curl -X DELETE https://api.silos.sh/v1/projects/proj_abc123 \
-H "Authorization: Bearer $SILOS_API_KEY"Deleting a project removes its databases and their durable state. This is irreversible.