RErecruitwithatlas
Opportunities

Add linkages to an opportunity

Changed on

Additively links prospects (person IDs), target companies, and job-lead projects to an existing opportunity. All body fields are optional but at least one must be provided. Existing linkages are never removed, and re-adding an already-linked ID is a no-op (still returns 200). Merged person IDs are resolved to their canonical person automatically. Linking a job-lead project also adds its company as a target company, and attaching a prospect adds their current company as a target company — mirroring the create endpoint. The response echoes the full current linkage sets (not just the additions).

patch/api/v1/opportunities/{id}

Request

Path parameters

idstring uuid required

Opportunity ID

Example:550e8400-e29b-41d4-a716-446655440000

Request body

prospectIdsstring[] nullable

Person IDs to attach as prospects (max 50) — the id from GET /api/v1/people, not CompanyContact junction IDs or prospects[].id rows. Additive — already-linked people are skipped. Merged IDs are resolved to their canonical person automatically.

companyIdsstring[] nullable

Target companies to add (max 50). Additive — already-linked companies are skipped.

jobLeadIdsstring[] nullable

Projects to link as job leads (max 50). Additive — already-linked projects are skipped.

Response

Linkages added

status'ok' required

Changes