RSC Release Notes

New APIs

RSC now supports the following two new versioned REST APIs.

Summary Resource Methods Documentation
Sync resumes as attachments for applications attachments batch_update, batch_delete Upload and sync attachments
Retrieve application evaluations generated by LinkedIn Hiring Assistant (LiHA) exportedApplicationEvaluations finder Exported application evaluation

APIs migrated from v2 to REST

The following endpoints have been migrated from the unversioned v2 API to the versioned rest API. The table lists the unversioned and versioned endpoint paths, supported methods, field-level changes required for migration, and references to learn more.

Summary Unversioned endpoint Versioned endpoint Methods Changes Documentation
Sync and manage ATS candidates v2/atsCandidates rest/candidates batch_update, batch_get, batch_delete • atsCandidateId → externalCandidateId
• atsCreatedAt → externalCreatedAt
• atsLastModifiedAt → externalLastModifiedAt
• dataProvider removed		 Sync candidates
Manage ATS integration instances v2/atsIntegrations rest/integrations batch_partial_update, batch_get, finder • dataProvider removed from entity keys Integration types
Manage integration configuration settings v2/atsIntegrationConfigurations rest/integrationConfigurations batch_update, batch_get • dataProvider removed from entity keys Customer configuration
Retrieve recruiter seat and contract information v2/seatsV2 rest/seatsV2 finder • id → seatId
• created.time → createdAt.actor + createdAt.time		 Recruiter seatholders
Sync notes for ATS candidates v2/atsCandidates/{id}/notes rest/candidateNotes batch_update, batch_delete • atsCandidateId → externalCandidateId
• ids → externalNoteId
• atsCreatedAt → externalCreatedAt
• externalLastModifiedAt added
• dataProvider removed		 Sync candidate notes
Sync notes for ATS applications v2/atsApplications/{id}/notes rest/applicationNotes batch_update, batch_delete • atsJobApplicationId → externalJobApplicationId
• ids → externalNoteId
• dataProvider removed		 Sync application notes
Manage entity access control lists v2/atsEntityAcls rest/entityAcls batch_update, batch_delete, finder • atsEntityAclId → entityAclId
• atsEntityId → entityId
• atsEntityType → entityType		 Sync ACLs
Manage entity ACL assignees v2/atsEntityAclAssignees rest/entityAclAssignees batch_update, batch_delete, finder • atsEntityAclId → entityAclId
• atsEntityId → entityId
• atsEntityType → entityType		 Sync ACLs
Retrieve InMail stub profiles v2/mailStubs rest/mailStubs finder • location type changed from string to profileLocation object (locationName, countryCode) InMail stub profiles
Sync application interview feedback v2/atsApplications/{id}/interviewFeedback rest/applicationInterviewFeedbacks batch_update, batch_delete • atsJobApplicationId → jobApplicationId
• interviewFeedbackId added as key param
• dataProvider removed		 Sync application interview feedback
Sync application stages v2/atsApplications/{id}/stages rest/applicationStage batch_update, batch_delete • atsJobApplicationId → jobApplicationId
• atsCreatedAt → externalCreatedAt
• externalLastModifiedAt added
• dataProvider removed		 Sync application stages
Retrieve exported candidates v2/exportedCandidates rest/exportedCandidates finder • externalJobPostingId removed
• referenceEntityType added
• referenceEntityId added
• source added		 Retrieve exported candidates

Changelog

The following sections document all RSC API changes by version and other documentation updates.

RSC 1.0 and RSC+ overview updates

  • RSC overview updates:
    • Added RSC 1.0 vs RSC+ feature comparison table and Connected Projects section
    • Added note that existing RSC partners need an amended API agreement to enable RSC+ features See RSC Overview

RSC data quality thresholds

  • RSC data quality requirements: Added new page documenting data quality thresholds that partners must meet before RSC certification and GA. Covers applicant evaluation, sourcing and intake, and ACL completeness metrics.

See RSC data quality requirements

  • Recommended Matches and Unified Search removed: All references to Recommended Matches and Unified Search are removed from Recruiter System Connect documentation. The dedicated pages, TOC entries, integration types table rows, and widget URL migration guide entries for these features are no longer available.

Version 202603 (latest)

Note

Use LinkedIn-Version: 202603 in your API requests to access the most recent features. See RSC Migration Guide for migration details from previous versions.

New fields

  • vanityIdentifier added to jobRequisitions (LinkedIn-Version: 202603):

    • New optional field that provides a human-readable, customer-facing identifier for a job requisition (for example, Req ID). This is distinct from the canonical externalJobRequisitionId used internally.
    Field Type Required Description
    vanityIdentifier String Optional Customer-facing display identifier for the job requisition (for example, Req ID).

    See Sync Job Requisitions

Version summary

Version Header Base Path Changes
202603 https://api.linkedin.com/rest/ None

Version 202602

  • candidates renamed:

    • dataProvider removed
    • Supported methods: batch_update, batch_get, batch_delete
    • Resource renamed from atsCandidates to candidates; three fields renamed:
    Change Before After
    Path v2/atsCandidates rest/candidates
    Key param atsCandidateId externalCandidateId
    Body field atsCreatedAt externalCreatedAt
    Body field atsLastModifiedAt externalLastModifiedAt
    Key param dataProvider Removed

  • integrations and integrationConfigurations renamed:

    • No field changes
    • integrations supported methods: batch_partial_update, batch_get, finder
    • integrationConfigurations supported methods: batch_update, batch_get
    • Resource names updated:
    Before After
    v2/atsIntegrations rest/integrations
    v2/atsIntegrationConfigurations rest/integrationConfigurations

    See Customer Configuration

  • Data Deletion:

    • Added DELETE /rest/candidates, replacing DELETE /v2/atsCandidates
    • Renamed parameter atsCandidateId to externalCandidateId

    See Data Deletion

Version 202512

  • seatsV2 externalized:

    • Path updated from v2/seatsV2 to rest/seatsV2
    • Supported methods: finder
    • Two response fields changed:
    Field Before After
    Seat ID id seatId
    Creation audit created.time createdAt.actor + createdAt.time

    See Recruiter Seatholders

  • candidateNotes and applicationNotes renamed:

    • Resource path changed from v2/atsCandidates/{id}/notes to rest/candidateNotes
    • Resource path changed from v2/atsApplications/{id}/notes to rest/applicationNotes
    • dataProvider removed
    • Supported methods: batch_update, batch_delete
    • Fields renamed:
    Field candidateNotes Before → After applicationNotes Before → After
    Path v2/atsCandidates/{id}.../notes → rest/candidateNotes v2/atsApplications/{id}.../notes → rest/applicationNotes
    Candidate param atsCandidateId → externalCandidateId atsJobApplicationId → externalJobApplicationId
    Note param ids → externalNoteId ids → externalNoteId
    Timestamp atsCreatedAt → externalCreatedAt —
    Added externalLastModifiedAt —
    Removed dataProvider dataProvider

    See Sync Candidate Notes

  • Data Deletion:

    • Added DELETE /rest/candidateNotes and DELETE /rest/applicationNotes

    See Data Deletion

Version 202511

  • entityAcls and entityAclAssignees renamed:

    • Resources renamed from atsEntityAcls and atsEntityAclAssignees, respectively
    • Supported methods: batch_update, batch_delete, finder
    • Three key params renamed:
    Field Before After
    Path v2/atsEntityAcls / v2/atsEntityAclAssignees rest/entityAcls / rest/entityAclAssignees
    Key param atsEntityAclId entityAclId
    Key param atsEntityId entityId
    Key param atsEntityType entityType

    See Sync ACLs

Version 202510

  • mailStubs externalized:

    • Supported methods: finder
    • Path updated from v2/mailStubs to rest/mailStubs
    • location response field type changed:
    Field Before After
    Path v2/mailStubs rest/mailStubs
    location type string profileLocation object (locationName, countryCode)

    See Retrieve Exported Candidates

  • Data Deletion:

    • Added DELETE /rest/attachments
    • Supports deleting synced resume attachments

    See Data Deletion

Version 202508.02

  • applicationInterviewFeedbacks renamed:

    • dataProvider removed from key params
    • Supported methods: batch_update, batch_delete
    • Resource path changed from v2/atsApplications/{id}/interviewFeedback to rest/applicationInterviewFeedbacks:
    Change Before After
    Path v2/atsApplications/{id}.../interviewFeedback?ids={id} rest/applicationInterviewFeedbacks
    Key params atsJobApplicationId, dataProvider, integrationContext jobApplicationId, interviewFeedbackId, integrationContext

    See Sync Application Interview Feedback

Version 202508

  • attachments new endpoint:

    • New rest/attachments endpoint for syncing resumes as attachments; supports batch_update, batch_delete

    See Upload and Sync Attachments

Version 202507

  • simpleJobPostings REST migration:

    • Private RSC job postings removed from simpleJobPostings
    • simpleJobPostings, simpleJobPostingStatus, and simpleJobPostingTasks moved to rest/ base path:
    Endpoint Before After
    simpleJobPostings v2/simpleJobPostings; supports private (RSC) and public jobs rest/simpleJobPostings; private RSC job postings no longer supported; RSC partners must use jobRequisitions
    simpleJobPostingStatus v2/simpleJobPostingStatus rest/simpleJobPostingStatus; no field changes
    simpleJobPostingTasks v2/simpleJobPostingTasks rest/simpleJobPostingTasks; no field changes

    See Sync Job Postings and RSC Migration Guide

  • applicationStage renamed:

    • dataProvider removed
    • Supported methods: batch_update, batch_delete
    • Resource path changed from v2/atsApplications/{id}/stages to rest/applicationStage
    • Timestamp fields renamed:
    Change Before After
    Path v2/atsApplications/{id}.../stages?ids={stageId} rest/applicationStage
    Key params atsJobApplicationId, dataProvider, integrationContext jobApplicationId, jobApplicationStageId, integrationContext
    Timestamp fields atsCreatedAt externalCreatedAt, externalLastModifiedAt (added)

    See Sync Application Stages

  • exportedApplicationEvaluations new endpoint:

    • New GET https://api.linkedin.com/rest/exportedApplicationEvaluations
    • Retrieves evaluation data generated by LinkedIn Hiring Assistant (LiHA)
    • Supported methods: finder

    See Application Evaluation Overview

  • exportedCandidates updated:

    • Path updated to GET https://api.linkedin.com/rest/exportedCandidates
    • Supported methods: finder
    • Field changes:
    Change Before After
    Removed field externalJobPostingId —
    Added fields — referenceEntityType, referenceEntityId, source

    See Retrieve Exported Candidates

  • atsPurgedExportedCandidates versioned:

    • Path updated from v2/atsPurgedExportedCandidates to rest/atsPurgedExportedCandidates
    • No field changes

    See Retrieve Exported Candidates

  • atsApplications updated:

    • dataProvider removed from key params
    • Path updated to rest/atsApplications
    • Two body fields added:
    Change Before After
    Path v2/atsApplications rest/atsApplications
    Key params atsJobApplicationId, dataProvider, integrationContext atsJobApplicationId, integrationContext
    Added body fields — atsJobRequisitionId, accessRestricted

    See Sync Applications

  • Data Deletion:

    • Added DELETE endpoints: DELETE /rest/atsApplications, DELETE /rest/applicationInterviewFeedbacks, DELETE /rest/applicationStage, DELETE /rest/jobRequisitions, DELETE /rest/jobRequisitionStages

    See Data Deletion

Version 202504

  • jobRequisitions and jobRequisitionStages new endpoints:

    • New rest/jobRequisitions endpoint syncs requisition data to LinkedIn; link to job postings via partnerRequisitionId in simpleJobPostings; supports batch_update, batch_delete
    • New rest/jobRequisitionStages endpoint manages requisition lifecycle stages; supports batch_update, batch_delete

    See Job Requisition API Migration Guide

December 2025

  • One-Click Export context:
    • Added description of Enhanced 1CE fields (email addresses, years of experience, skills, work positions, education history). See StubProfile

November 2025

  • Application Evaluation enhancements:

    • Added evaluationProfileURL field - link to candidate's Recruiter profile page for the evaluation
    • Updated criteriaClassification enum value from Meet to Meets See Export Application Evaluation

  • RSC Migration Guide updates:

    • Added hiredCount field to /jobRequisitions API
    • Added compensation field (new in Job Requisitions, not available in old API)
    • Clarified accessRestricted field mapping from extension schema
    • Updated field mapping for requisitionType and owners fields
    • Clarified job requisition stage purpose for application progression See RSC Migration Guide

October 2025

  • New Child Application Secret Management APIs:

    • Added support for rotating and deleting secrets for parent, child, and standalone applications
    • Partners can now maintain up to two active secrets per application, enabling zero-downtime credential updates See Application Secret Management

  • Application Evaluation documentation updates:

    • Added evaluationClassification field to indicate candidate fit (TOP_FIT, MIGHT_BE_FIT, MIGHT_NOT_BE_FIT, UNKNOWN)
    • Updated criteriaClassification enum values from MATCH to MEET/DOES_NOT_MEET See Application Evaluation Overview

September 2025

  • Application Evaluation push notifications:

    • New webhook-based push notifications for application evaluations
    • Partners can now receive real-time updates when recruiters evaluate candidates See Receive Push Notifications

  • Export Application Evaluation API:

    • New endpoint for retrieving detailed evaluation data
    • Includes recruiter feedback, ratings, and decision timestamps See Export Application Evaluation

March 2024 -- updates to atsCandidates

  • Updated Sync Candidates to indicate that the firstName field is required Updated Sync Candidates to add doNotContact field Updated Sync Candidates updated phone number and address fields to indicate they are required but can be empty
  • Changed Stubprofile emailAddress field lists array of email to type string.

October 2023 -- One-Click Export limits

  • Limits for One Click Export updated to 300 requests per month per seat.

July 2023 minor updates

  • Updated Retrieving Closed Candidate Profiles documentation to describe expected partner behavior: Our ATS partners must query this endpoint periodically (at least once in 30 days) and notify end customers that they may need to delete the data that appear within this endpoint from their records if they do not have a legal basis to continue processing it.

June 2023

  • Sync Candidates - Updated description for externalProfileUrl and added linkedInProfileUrl in Request Body Fields.

May 2023

  • Added new technical questions in RSC FAQ

November 2021

A consolidated summary of the new validation changes is below.

Sync Candidates

Endpoint Field Type New validation(s)
/atsCandidates atsCreatedAt Integer Value must be greater than 0
/atsCandidates atsLastModifiedAt Integer Value must be greater than 0
Value must be greater than or equal to atsCreatedAt
/atsCandidates emailAddresses String[] Emails must follow X@X.X pattern

Sync Applications

Endpoint Field Type New validation(s)
/atsApplications atsCreatedAt Integer Value must be greater than 0
/atsApplications atsLastModifiedAt Integer Value must be greater than 0
Value must be greater than or equal to atsCreatedAt
/atsApplications atsJobPostingId String Min. length: 1
/atsApplications atsJobPostingName String Min. length: 1
/atsApplications candidateEmail String Email must follow X@X.X pattern
/atsApplications firstName String Min. length: 1
/atsApplications lastName String Min. length: 1
/atsApplications source String Min. length: 1

Sync Application Stages

Endpoint Field Type New validation(s)
/atsApplications/{atsJobApplicationId}/stages atsCreatedAt Integer Value must be greater than 0
/atsApplications/{atsJobApplicationId}/stages stage String Min. length: 1
Value cannot be "Not Available"

June 2021

May 2021

April 2021

June 2020

April 2020

  • Added Required Fields table for all Recruiter System Connect APIs.
  • Prospect Notes - Added push event type of DELETE_PROSPECT_NOTE to process customer deleted Recruiter notes.
  • Sync Jobs - Added note on how to update job posting from PUBLIC to PRIVATE_TO_ATS_INTEGRATION.

May 2019

January 2019

Sync Candidates - Updated Retrieve Candidate Matches with field projection: matchedMembers, manualMatchedMember.

September 2018

<script type="text/javascript" src="https://platform.linkedin.com/xdoor/scripts/in.js">
  api_key: <enter api key here>
  extensions: HcmWidget@https://www.linkedin.com/recruiter/widget/hcm
</script>

Customer Configuration Plugin - Updated references from "https://www.linkedin.com/uas/in.js" to "https://platform.linkedin.com/xdoor/scripts/in.js". Example of the change below:

<script type="text/javascript" src="https://platform.linkedin.com/xdoor/scripts/in.js">
  api_key: { Enter the customer app API key (client_id) received in the Provisioning API response. }
  extensions: ATSIntegrationWidget@https://platform.linkedin.com/rsc/extensions/onboarding-widget
</script>

August 2018

  • InMail History - Removed note that InMail content is only visible to the sender/receiver of the particular InMail.

June 2018

April 2018

March 2018

  • Referrals - Updated communication that we are no longer accepting new LinkedIn Referrals integrations
  • InMail History - Added note that InMail content is only visible to the sender/receiver of the particular InMail.
  • Profile Plugin - Added callback function for linking and unlinking profiles. See example below:
<script type="text/javascript" src="https://www.linkedin.com/uas/in.js">
  api_key: <enter api key here>
  extensions: HcmWidget@https://www.linkedin.com/recruiter/widget/hcm
</script>

<script type="IN/HcmWidget"
  data-widget-type="ATS"
  data-ats-candidate-id="{your unique candidate id}"
  data-integration-context="{customer's integration context URN}"
  data-show-unlink-url="{true|false}"
  data-confirm-unlink="{true|false}"
  data-onlink="link"
  data-onunlink="unlink"  
  data-width="{Width}">
</script>

<script>
  function link(profile) {
     console.log("Link callback", memberToken);
  }
  function unlink(profile) {
     console.log("Unlink callback", memberToken);
  }
</script>
  • Records Per Minute Throttle - In addition to our daily call limits we have a per minute throttle applied to batch calls. See example below:
Throttle Limits Requests Per Day (UTC) Records Per Minute
Application maximum 100,000 2,000
  • Last updated on