List development link suggestions

Returns provider artifacts (branches, commits, pull requests) that reference the work item’s key but are not yet linked, so a caller can offer one-click linking. Read-only; creating the link is a separate POST.

GET/api/v1/work-items/:id/engineering/suggestions

Authorization

work-items:readapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Canonical work-item ID

Example: work_01k2...

Request

GET /api/v1/work-items/:id/engineering/suggestions

curl -X GET "https://www.digitalstack360.com/api/v1/work-items/work_01k2.../engineering/suggestions" \
  -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": [
    {
      "artifactType": "branch",
      "externalRef": "feature/DS-42-checkout",
      "repositoryFullName": "acme/storefront"
    }
  ],
  "meta": {
    "count": 1
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks work-items:read scope

404

not_found

Work item does not exist or is outside the resolved workspace