Create project
Changed onCreate a project to group deployments and applications under a workspace-scoped slug.
The slug you provide is the stable, caller-defined handle used to reference this project in subsequent operations (get, update, delete). It must be unique within your workspace.
Important: The slug cannot collide with an existing project in your workspace. A duplicate slug returns a 409 conflict.
Required Permissions
Your root key must have the following permission:
- project.*.create_project (to create projects in your workspace)
Request
- Base URLhttps://api.unkey.com
- URLhttps://api.unkey.com/v2/projects.createProject
- AuthHTTP bearer
Request body
Example request
{
"name": "Payments Service",
"slug": "proj_1234abcd"
}Response
Project created successfully. The response contains the project id used to reference it in subsequent operations.
Example response
{
"meta": {
"requestId": "req_123"
},
"data": {
"id": "proj_1234abcd"
}
}Changes
- info
the endpoint scheme security
bearerwas added to the API - info
the endpoint scheme security
rootKeywas removed from the API
- info
- breaking
the
request property's maxLength was decreased to255 - breaking
the
request property's minLength was increased from1to3 - warning
changed the pattern of the request property
from^[a-z0-9]+(-[a-z0-9]+)*$to^[a-zA-Z0-9_-]+$
- breaking