POST https://ed.link/api/v2/teams/:team_id/sources/:source_id/links
Creates a new link between two team-owned sources and queues an enrichment job.
Permissions
Requires the links.update system permission.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
:team_id | UUID | Yes | The ID of the team. |
:source_id | UUID | Yes | The ID of the primary source. |
Request Body
| Property | Type | Required | Description |
|---|---|---|---|
primary_source_id | UUID | Yes | Primary source identifier. |
secondary_source_id | UUID | Yes | Secondary source identifier to link. |
priority | Number | No | Enrichment priority ordering (higher values take precedence). |
properties | Object | No | Matching rules and field mapping overrides. |
permissions | Array | No | Scoped permission IDs allowed during linking. |
Sample Request
const response = await axios.post(
`https://ed.link/api/v2/teams/${team_id}/sources/${source_id}/links`,
{
primary_source_id: source_id,
secondary_source_id: '1c7a216b-4e09-4d24-8f47-c0e815617a22',
priority: 1
},
{
headers: {
authorization: `Bearer ${user_session_token}`,
'content-type': 'application/json'
}
}
);
Sample Response
{
"$data": {
"id": "d132a0c4-954f-4d32-8ea7-a36c93427db9",
"primary_source_id": "7b5a19cb-9ea8-4b71-9b16-564ec5ea0b12",
"secondary_source_id": "1c7a216b-4e09-4d24-8f47-c0e815617a22",
"priority": 1
}
}