Refresh GitHub development links

Fetches current provider state for the work item’s GitHub links (branch existence, commit status, PR state) and applies monotonic updates. Manual, on-demand counterpart of scheduled polling.

POST/api/v1/work-items/:id/engineering/refresh

Authorization

work-items:linkapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Canonical work-item ID

Example: work_01k2...

Request

POST /api/v1/work-items/:id/engineering/refresh

curl -X POST "https://www.digitalstack360.com/api/v1/work-items/work_01k2.../engineering/refresh" \
  -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": {
    "refreshed": 3,
    "updated": 1,
    "unchanged": 2,
    "failures": []
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks work-items:link scope

404

not_found

Work item does not exist or is outside the resolved workspace