.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=309fd13aafaa2459ab88bae66ee69fdb)
.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=d463f8e401c13f13ee15256db8c610dd)
Platform API reference
Create Project Link
Link one of your platform’s projects to an OpenTrain job. externalProjectId must be unique per install; emits project_link.created.
POST
Creates a project link mapping one of your projects to an OpenTrain job. Contract lifecycle events are emitted only for linked jobs, so this is the routing step of the integration. Emits a
project_link.created event.
Requirements: project-links:write scope.
Request
string
required
Your project’s identifier (max 200 chars). Unique per install — reusing one returns
409.string
Human-readable project name (max 300 chars).
string
Deep link to the project in your platform (max 2048 chars).
string
The OpenTrain job to link. Must be a job owned by the installing employer — anything else returns
404. A link without a job receives no contract events until it points at one.string
default:"PARTNER_WEBHOOK"
PARTNER_WEBHOOK (you provision workspace members from webhook events — recommended) or MANAGED_ADAPTER (the OpenTrain managed-credential path). See provisioning modes.Response
object
The created link:
{id, jobId, externalProjectId, externalProjectName, externalProjectUrl, provisioningMode, createdAt}.