API reference

Create a project

POST/v1/projects

Authorization

Send a personal API key or an OAuth access token as Authorization: Bearer <token>.

OAuth scopes: projects:write

Parameters

Idempotency-Keystring, header
Optional unique key. When supplied, retries with the same key and body replay the original response for 24 hours.

Request body

application/json, required

namestringrequired
descriptionstring
visibility"private" | "team"
memoryScope"project" | "workspace"

Responses

201Success

projectobjectrequired
idstringrequired
namestringrequired
descriptionstring | nullrequired
visibility"private" | "team"required
memoryScope"project" | "workspace"required
taskCountnumberrequired
createdAtstringrequired
updatedAtstringrequired

400Invalid request

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

401Missing or invalid Bearer credential

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

402Payment or subscription required

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

403Credential is missing a required scope

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

404Resource not found

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

409Request conflict

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

429Rate limit exceeded

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

500Internal API error

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

curl --request POST \
  --url 'https://api.staging.adam.new/v1/projects' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Reduce mass while preserving the mounting envelope.",
  "name": "Gearbox redesign",
  "visibility": "private"
}'

{
  "project": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "visibility": "private",
    "memoryScope": "project",
    "taskCount": 123,
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}