Create a development link

Manually links one development artifact (branch, commit, or pull request) to a work item. The link points at the artifact in its provider; it never mutates the repository.

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

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 body

artifact_typestringrequired"branch" | "commit" | "pull_request"

Kind of development artifact

external_refstringrequired

Provider-native reference: branch name, commit SHA, or PR number

repository_full_namestringrequired

owner/repo the artifact lives in

provider_keystringoptional

Provider identifier (defaults to github)

external_urlstringoptional

Deep link to the artifact

titlestringoptional

Display title snapshot

Example request

{
  "artifact_type": "pull_request",
  "external_ref": "42",
  "repository_full_name": "acme/storefront",
  "title": "Checkout redesign"
}

Request

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

curl -X POST "https://www.digitalstack360.com/api/v1/work-items/work_01k2.../engineering/links" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artifact_type":"pull_request","external_ref":"42","repository_full_name":"acme/storefront","title":"Checkout redesign"}'

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

Response

200 OK

{
  "data": {
    "id": "del_01k2...",
    "providerKey": "github",
    "repositoryFullName": "acme/storefront",
    "artifactType": "pull_request",
    "externalRef": "42",
    "linkMethod": "manual"
  }
}

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 work-items:link scope

404

not_found

Work item does not exist or is outside the resolved workspace

400

invalid_link

Link fields fail validation

409

link_already_exists

This artifact is already linked to the work item