Description

The response to https://api.smartrecruiters.com/feed/publications/{postingId} now contains customFields. This allows users to retrieve custom fields associated with a posting.

Impact

This enhancement is backward-compatible and does not require any changes to existing client implementations.

References

• Feed API - Get posting by id

Description

New property noPolicyDescription was added to settings.consentSettings object in the response of the Get application configuration for posting endpoint.

This property is a disclaimer that should be used to notify candidates that their personal data is bound by your company's privacy policy. It's returned when company privacy policy has not been defined.

Impact

This enhancement is backward-compatible and does not require any changes to existing client implementations.

References

• API Reference
• Guidelines

Description

Introducing the new public API - Candidate Status API.
This API allows to retrieve candidates application status from the candidate perspective.

Possible statuses are: NEW, IN_REVIEW, INTERVIEW, OFFERED, HIRED, ARCHIVED.
For ARCHIVED there is also substatus returned: REJECTED, WITHDRAWN_BY_APPLICANT, TRANSFERRED, DELETED_BY_COMPANY.

To use this API, you must be granted the candidate_view_application_status_read access scope.

Impact

There are neither breaking changes in the existing API nor any migration steps required.

References

• Candidate Status API
• Access scopes

Description

Added optional name and description parameters to the POST /webhooks-api/v201907/subscriptions endpoint request and response.
Both fields are validated:

• name should have maximum length of 100 characters, and contain only alphanumeric characters and spaces,
• description should have maximum length of 500 characters, and cannot contain ;\<>{} characters.

If present, name and description parameters will be added to responses for endpoints:

• GET /webhooks-api/v201907/subscriptions
• GET /webhooks-api/v201907/subscriptions/{subscriptionId}

Impact

This enhancement is backward-compatible and does not require any changes to existing client implementations.

References

• Webhooks API

Description

Extending Configuration API by adding endpoints allowing to manage Predefined Locations:

• GET configuration/predefined-locations - Get many predefined locations
• GET configuration/predefined-locations/{id} - Get one predefined location
• POST configuration/predefined-locations - Create a predefined location
• PUT configuration/predefined-locations/{id} - Update a predefined location
• DELETE configuration/predefined-locations - Delete many predefined location
• DELETE configuration/predefined-locations/{id} - Delete a predefined location

Impact

This enhancement is backward-compatible and does not require any changes to existing client implementations.

References

• Configuration API

Description

Extending Configuration API by adding key parameter in response to endpoints:

• GET configuration/job-properties
• POST configuration/job-properties
• GET configuration/job-properties/id
• PATCH configuration/job-properties/id

Impact

This enhancement is backward-compatible and does not require any changes to existing client implementations.

References

• Configuration API

Description

Extending Configuration API by adding the following endpoints to read career site configuration:

• GET /configuration/career-sites: Lists career sites configurations using pagination.
• GET /configuration/career-sites/{careerSiteId}: Get details of a single career site configuration by id.

To use these endpoints, you need to be granted the configuration_read access scope.

Impact

This enhancement is backward-compatible and does not require any changes to existing client implementations.

References

• Configuration API
• Access scopes

Description

Extending Posting API by adding jobAdId parameter to the GET /postings endpoint. This parameter allows to filter postings by jobAdId.

Impact

This enhancement is backward-compatible and does not require any changes to existing client implementations.

References

• Posting API

Description

Extending Self Scheduling API by adding endpoints to:

• retrieve available slots for interview
• create interview at a specific slot
• update interview at a specific slot

To use this API, you will need the following access scopes: self_schedules_read or self_schedules_manage.

Impact

The Self Schedule API allows to create, delete and search for interview self schedules, providing similar functionality as the UI.
Self scheduling allows candidate to pick up the time slot for the interview, and interview would be created as a result.

References

• Self Schedules API
• Access scopes

Description

Assessment API(v1) endpoints, that were officially sunset on June 10th 2024, are removed. This API was replaced by the Assessment API(2021).
Removed endpoints:

• GET https://api.smartrecruiters.com/v1/assessments
• POST https://api.smartrecruiters.com/v1/assessments
• POST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/reject
• POST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/complete
• POST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/accept
• GET https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}
• GET https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/comments
• POST https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/comments
• GET https://api.smartrecruiters.com/v1/assessments/{assessmentOrderId}/comments/{commentId}

Related Offers API(v1) endpoints are also removed:

• POST https://api.smartrecruiters.com/v1/offers
• GET https://api.smartrecruiters.com/v1/offers/{offerId}
• POST https://api.smartrecruiters.com/v1/offers/{offerId}
• POST https://api.smartrecruiters.com/v1/offers/{offerId}/withdraw
• POST https://api.smartrecruiters.com/v1/offers/{offerId}/submit

with the exception of GET https://api.smartrecruiters.com/v1/offers, which is not removed.

Impact

This change is not backward-compatible.
All customers using the Assessment API(v1) and Offers API (v1) no longer have access to these APIs.
All integrations still using these APIs are affected.

References

• Assessment API (2021) Guide
• Assessment API (2021)