Skip to main content
POST
/
v1
/
projects
Create a project
curl --request POST \
  --url https://api.craftkit.dev/v1/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corp"
}
'
{
  "id": "3f9b6c2e-1a2b-4c3d-9e8f-7a6b5c4d3e2f",
  "slug": "acme-corp",
  "name": "Acme Corp"
}

Authorizations

​
Authorization
string
header
required

Account API key (ck_acct_…) presented as a bearer token. Distinct credential system from bearerApiKey — validated against a separate table, never against project keys or vice versa. Scoped to every project owned by the account; used only by the /v1/projects* endpoints below (each of which declares this scheme explicitly and does not inherit the document-level bearerApiKey default). Minted from the dashboard (Account → API keys) — there is no programmatic endpoint that issues an account key.

Body

application/json
​
name
string
required
Required string length: 1 - 120

Response

Project created.

Returned by create and rename.

​
id
string<uuid>
required
​
slug
string
required
​
name
string
required