Projects
Create and manage projects within your team. Projects are used to group registry items together.
Create a project
POST https://stow.build/api/projectsCreates a new project within the team associated with your API key.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name of the project. |
slug | string | Yes | URL friendly identifier. Automatically sanitized (lowercased, special characters removed). |
Example request
curl -X POST https://stow.build/api/projects \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "My Project", "slug": "my-project" }'Success response
Returns 201 Created with the new project:
{
"id": 1,
"name": "My Project",
"slug": "my-project"
}Error responses
| Status | Error | Cause |
|---|---|---|
400 | API key is required. | The x-api-key header is missing or empty. |
400 | Project name is required. | The name field is missing, empty, or not a string. |
400 | Project slug is required. | The slug field is missing, empty, or not a string. |
400 | Slug must contain at least one alphanumeric character. | The provided slug only contains special characters that get stripped during sanitization. |
401 | Unauthorized. | The API key is invalid. |
409 | A project with the slug "{slug}" already exists. | A project with the same slug already exists within your team. |
500 | Internal server error. | An unexpected error occurred. Try again later. |