Create a project

Creates one canonical DigitalStack project/engagement identity. GUI quick-start scaffolding and schedule mutation are intentionally not part of this command.

POST/api/v1/projects

Authorization

projects:writeapi key scoperequired

Required scope when calling with an API key.

Request body

namestringrequired

Project/engagement name

client_namestringoptional

Client display name

client_urlstringoptional

Client URL

project_typestringoptional

Blueprint/project type token

workflow_modestringoptional

guided or quick; no GUI scaffold is run by this API

linked_opportunity_idstringoptional

Approved source opportunity relationship

confirmbooleanrequired

Must be true

Example request

{
  "name": "Acme replatform",
  "client_name": "Acme",
  "workflow_mode": "guided",
  "confirm": true
}

Request

POST /api/v1/projects

curl -X POST "https://www.digitalstack360.com/api/v1/projects" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Idempotency-Key: project-create-acme-v1" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme replatform","client_name":"Acme","workflow_mode":"guided","confirm":true}'

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "ok": true,
    "project": {
      "id": "proj_abc123",
      "name": "Acme replatform",
      "status": "draft"
    },
    "changed_fields": [
      "name"
    ],
    "event_type": "project.created",
    "idempotency_replayed": false,
    "errors": []
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

400

bad_request

Missing or invalid request fields

403

scope_insufficient

Key lacks the required write scope

403

scope_insufficient

Key lacks projects:write scope

400

confirmation_required

confirm must be true