Description

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.

Impact

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

References

• Interview Templates API

Description

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}/translations
• PATCH /configuration/job-properties/{id}/translations

Impact

This change is not backwards compatible and will reject requests with translations containing only whitespace characters.
Previously such requests would be accepted.

References

• Configuration API

Description

Added new IP addresses used for outbound traffic from our production environment. The new IP addresses are:

• 18.159.217.255
• 18.156.108.167

Impact

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.

References

• Public IP addresses

Description

Extending Self Scheduling API by adding endpoints:

• POST /automated-self-schedules/update-invite - For updating pending self-schedule invites for automated self-schedules.
  Link to the self-schedule invite would stay the same, but the invite would be updated with new information.
  Pending invites are those that have not been accepted by the candidate by selecting an interview time slot.
• POST /automated-self-schedules/reschedule - For requesting self-reschedule from a candidate.
  Previous self-scheduled interview would be canceled.
  Existing self-schedule invites will be updated to allow the candidate to select a new time slot, which will be created as a new interview.
  Link to the self-schedule invite would stay the same.
• GET /self-schedules/{id}/application/{applicationUuid}/interview - For getting the interview details for a self-scheduled interview.

Impact

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

References

• Self Schedules API

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