---
title: "Requests invite update for automated self-schedule"
method: POST
path: "/automated-self-schedules/update-invite"
tags: ["self-schedules"]
---

# Requests invite update for automated self-schedule

`POST /automated-self-schedules/update-invite`

Requests automated self-schedule update for candidate.
Interview must NOT exist. If interview exists request self-reschedule must be used instead.
Old link to self-schedule will be valid.

## Request body

- AutomatedSelfScheduleUpdateInviteRequestDto
  - `selfScheduleId` string, uuid
  - `applicationId` string, uuid
  - `durationInMinutes` integer — Self-scheduled interview duration in minutes
  - `format` 'ONSITE_JOB' | 'ONSITE' | 'PHONE' | 'VIDEO' | 'VIDEO_CALENDAR' | 'VIDEO_MEETING_ZOOM' | 'OTHER' — Self-scheduled interview format
  - `location` string — Self-scheduled interview location. Depending on the format, can be empty or override default values. Per-format behavior ONSITE_JOB - if empty, job location would be used ONSITE - if empty, company location would be used PHONE, VIDEO - field is mandatory VIDEO_CALENDAR, VIDEO_MEETING_ZOOM - must be null or empty, link would be generated automatically OTHER - field is optional
  - `privateInterview` boolean
  - `hiringTeamRoleToInterviewerIds` object
  - `meetingHostId` string — User ID that will be the host of the meeting. Required for format VIDEO_MEETING_ZOOM and VIDEO_CALENDAR
  - `slotsAvailabilityLimitInDays` integer — Defines how many days in the future the candidate can self-schedule
  - `reminders` InterviewReminderDto[]
    - `channel` 'SMS' | 'WHATS_APP' | 'EMAIL' — Reminder channel, can be SMS, WHATS_APP or EMAIL
    - `advanceTimesInMinutes` integer[] — List of times in minutes prior to interview for which the reminder will be sent
    - `reminderMessageTemplateId` string — Template ID for the reminder messages. Template must be of type INTERVIEW_REMINDER
  - `communicationToCandidate` CommunicationToCandidateDto
    - `emailMessageTemplateId` string — Template must be of type REQUEST_SELF_RESCHEDULE for reschedules and INVITATION_TO_SELF_SCHEDULE_UPDATED for self-schedule updates
    - `smartMessage` SmartMessageDto
      - `channel` 'WHATS_APP' | 'SMS'
      - `messageTemplateId` string — Template must be of type REQUEST_SELF_RESCHEDULE for reschedules and INVITATION_TO_SELF_SCHEDULE_UPDATED for self-schedule updates
    - `repeat` PublicSelfScheduleRepeatInviteDto
      - `intervalInMinutes` integer
      - `count` integer

## Response `204`

When self-schedule invite was updated successfully

- object

## Other responses

- `400` — Incorrect input data
- `401` — Unauthorized

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)