List projects

Lists visible canonical projects/engagements for the resolved workspace. Archived projects are excluded unless requested.

GET/api/v1/projects

Authorization

projects:readapi key scoperequired

Required scope when calling with an API key.

Query parameters

querystringoptional

Case-insensitive match against project or client name

Example: Acme

statusstringoptional

draft, active, or archived

Example: active

limitnumberoptional

Maximum rows, clamped to 1–100

Example: 25

Request

GET /api/v1/projects

curl -X GET "https://www.digitalstack360.com/api/v1/projects" \
  -H "Authorization: Bearer $DS_API_KEY"

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

Response

200 OK

{
  "data": [
    {
      "id": "proj_abc123",
      "name": "Acme replatform",
      "client_name": "Acme",
      "status": "active",
      "updated_at": "2026-07-15T14:22:04Z"
    }
  ],
  "meta": {
    "count": 1,
    "truncated": false
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks projects:read scope