Update project settings

Updates bounded project settings such as workflow mode, portal config, AI config, and ticket prefix.

PATCH/api/v1/projects/:id/settings

Authorization

projects:writeapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Project ID

Example: proj_abc123

Request body

workflow_modestringoptional

Workflow mode

workflow_metadataobjectoptional

Workflow metadata object or null

portal_configobjectoptional

Portal config object or null

ai_configobjectoptional

AI config object or null

ticket_prefixstringoptional

Ticket prefix or null

confirmbooleanrequired

Must be true

Example request

{
  "ticket_prefix": "ACME",
  "confirm": true
}

Request

PATCH /api/v1/projects/:id/settings

curl -X PATCH "https://www.digitalstack360.com/api/v1/projects/proj_abc123/settings" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Idempotency-Key: project-settings-update-v1" \
  -H "Content-Type: application/json" \
  -d '{"ticket_prefix":"ACME","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,
    "settings": {
      "project_id": "proj_abc123",
      "ticket_prefix": "ACME"
    },
    "event_type": "project.settings_updated",
    "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