DEVELOPER DOCUMENTATION

List Project Links

List the project links on the current install, newest first.

GET/api/partner/v1/project-links

Lists every project link on the calling token’s install, newest first. There is no pagination — installs hold a bounded number of links.

Requirements: project-links:read scope (implied by project-links:write).

Request

No parameters.

Response

projectLinksobject[]

Array of project links, newest first. Each: {id, jobId, externalProjectId, externalProjectName, externalProjectUrl, provisioningMode, createdAt} — same shape as GET /project-links/{linkId}.

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing, invalid, or revoked token
`403`	`FORBIDDEN`	Token lacks `project-links:read`

Request examples

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

Response examples

{
  "projectLinks": [
    {
      "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"
    }
  ]
}