DEVELOPER DOCUMENTATION

Delete Project Link

Permanently remove a project link. The response carries a final snapshot, and a project_link.removed event is emitted.

DELETE/api/partner/v1/project-links/{linkId}

Permanently removes a project link. The link row is hard-deleted — the response and the emitted project_link.removed event carry the final snapshot of its data. Contract events for the job stop unless another link on the install references the same job.

There is no update operation on links: to re-point a project at a different job, delete and create again.

Requirements: project-links:write scope.

Request

linkIdstringpathrequired

The project link ID to remove.

Response

projectLinkobject

Final snapshot of the removed link: {id, jobId, externalProjectId, externalProjectName, externalProjectUrl, provisioningMode, createdAt}.

deletedboolean

Always true on success.

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing, invalid, or revoked token
`403`	`FORBIDDEN`	Token lacks `project-links:write`
`404`	`NOT_FOUND`	No link with this ID on this install

Request examples

curl -sS -X DELETE https://app.opentrain.ai/api/partner/v1/project-links/<LINK_ID> \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

Response examples

{
  "projectLink": {
    "id": "<LINK_ID>",
    "jobId": "<OPENTRAIN_JOB_ID>",
    "externalProjectId": "42",
    "externalProjectName": "Traffic signs batch 3",
    "externalProjectUrl": "https://your-platform.example.com/projects/42",
    "provisioningMode": "PARTNER_WEBHOOK",
    "createdAt": "2026-06-12T10:00:00.000Z"
  },
  "deleted": true
}