Posting API expose additional property compensation in the response of the following endpoint:
GET /v1/companies/{companyIdentifier}/postings/{postingId}It is optional and will be returned only if the posting has compensation information.
This change is backwards compatible and does not require any changes in the existing clients.
Introduced a new field to the Self Scheduling API called meetingHostId. It shows the person who will act as the host for interviews created from self schedule. The host identity will be used to create calendar events and video meetings.
It will be returned if the self schedule has been created with meeting host configured, otherwise it will be null.
It is added to responses of the following endpoints:
This enhancement is backward-compatible and does not require any changes to existing client implementations.
As part of improvement of interview templates API, we are deprecating zoomHostId and organizerId fields in creation and update of interview templates API.
In directly it results in the retrieval endpoint to also have these fields deprecated.
Client should not use zoomHostId and organizerId fields in the requests to create or update interview templates as they are inappropriate at interview templates.
Client should consider meetingHostId for in job interview templates API instead.
Introduced a new optional field to the Interview Templates API called meetingHostId. This field can be added to Update job interview template request to specify the person who will act as the host for interviews created from this template. The host identity will be used to create calendar events and video meetings.
The meetingHostId field was also added to the interviewTemplate object in the response of the Find interview templates for job application id endpoint.
This enhancement is backward-compatible and does not require any changes to existing client implementations.
Added enriched validation for the LabelTranslation object by requiring at least one non-whitespace character in label field.
This is also reflected in the OpenAPI specification:
LabelTranslation:
type: object
properties:
label:
type: string
minLength: 1
maxLength: 200
+ pattern: "^(?!\\s*$).+"
This validation is enforced for the request body of the following endpoints:
PATCH /configuration/job-properties/{id}/values/{valueId}/translationsPATCH /configuration/job-properties/{id}/translationsThis change is not backwards compatible and will reject requests with translations containing only whitespace characters.
Previously such requests would be accepted.
Added new IP addresses used for outbound traffic from our production environment. The new IP addresses are:
The clients who accept traffic only for SR outbound IPs need to update their firewalls, security groups, or allowlists.
The new IPs will be enabled for use by the production infrastructure three weeks after the publication of this message.
Added support for the compensation object in the Job Ad.
Added period property for the compensation object.
period:
type: string
enum:
- HOURLY
- DAILY
- WEEKLY
- MONTHLY
- YEARLY
Job Ad can be created and updated with optional compensation object.
If set, compensation will be included in the Job Ad response.
Compensation object can be created and updated with optional period property.
This change is backwards compatible and does not require any changes in the existing clients.
Extending Self Scheduling API by adding endpoints:
POST /automated-self-schedules/update-invite - For updating pending self-schedule invites for automated self-schedules.POST /automated-self-schedules/reschedule - For requesting self-reschedule from a candidate.GET /self-schedules/{id}/application/{applicationUuid}/interview - For getting the interview details for a self-scheduled interview.This enhancement is backward-compatible and does not require any changes to existing client implementations.
The response to https://api.smartrecruiters.com/feed/publications/{postingId} now contains customFields. This allows users to retrieve custom fields associated with a posting.
This enhancement is backward-compatible and does not require any changes to existing client implementations.
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.
This enhancement is backward-compatible and does not require any changes to existing client implementations.