.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=309fd13aafaa2459ab88bae66ee69fdb)
.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=d463f8e401c13f13ee15256db8c610dd)
curl -sS https://app.opentrain.ai/api/partner/v1/project-links/<LINK_ID> \
-H "Authorization: Bearer $OT_PARTNER_TOKEN"
{
"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"
}
}
Platform API reference
Get Project Link
Retrieve one project link by ID.
GET
/
api
/
partner
/
v1
/
project-links
/
{linkId}
curl -sS https://app.opentrain.ai/api/partner/v1/project-links/<LINK_ID> \
-H "Authorization: Bearer $OT_PARTNER_TOKEN"
{
"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"
}
}
Retrieves one project link on the calling token’s install.
Requirements:
project-links:read scope (implied by project-links:write).
Request
Response
object
Show ProjectLink fields
Show ProjectLink fields
string
Link ID.
string | null
The linked OpenTrain job, or
null if the link is not job-bound yet.string
Your project’s identifier — unique per install.
string | null
Human-readable project name.
string | null
Deep link to the project in your platform.
string
PARTNER_WEBHOOK or MANAGED_ADAPTER — see provisioning modes.string
ISO 8601 creation timestamp.
Errors
| Status | code | Meaning |
|---|---|---|
401 | UNAUTHORIZED | Missing, invalid, or revoked token |
403 | FORBIDDEN | Token lacks project-links:read |
404 | NOT_FOUND | No link with this ID on this install |
curl -sS https://app.opentrain.ai/api/partner/v1/project-links/<LINK_ID> \
-H "Authorization: Bearer $OT_PARTNER_TOKEN"
{
"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"
}
}
⌘I