Navigation
API Overview
The Container Duck API lets you manage projects and apps programmatically. All endpoints require authentication.
Base URL
https://your-instance.containerduck.com/api/v1
Authentication
Include your JWT token in the Authorization header:
Authorization: Bearer <your-token>
Endpoints
Projects
| Method | Path | Description |
|---|---|---|
| GET | /projects | List all projects |
| POST | /projects | Create a new project |
| GET | /projects/:id | Get project details |
| DELETE | /projects/:id | Delete a project |
Apps
| Method | Path | Description |
|---|---|---|
| GET | /projects/:id/apps | List apps in a project |
| POST | /projects/:id/apps | Install an app |
| GET | /apps/:id | Get app details |
| DELETE | /apps/:id | Remove an app |
| POST | /apps/:id/deploy | Trigger a deployment |
Hosted Apps
| Method | Path | Description |
|---|---|---|
| POST | /projects/:id/hosted-apps | Deploy from GitHub |
| PUT | /hosted-apps/:id/env | Update environment variables |
| GET | /hosted-apps/:id/logs | Get build logs |
Rate Limits
API requests are limited to 100 requests per minute per user. Rate limit headers are included in every response.
SDKs
Official SDKs are coming soon. In the meantime, you can use the REST API directly with any HTTP client.