Update organization phone-interview call policy
Read or partially update your organization’s outbound phone-interview call policy. The policy governs automatic dialing for phone interviews and applies to the entire organization. There is no per-job override.
Changes apply to calls scheduled after the PATCH. Call sequences already in progress continue under the policy that was in force when they started.
Each candidate receives one initial dial plus one retry per entry in retry_delay_sequence — the number of retries equals the number of entries. Retries are only placed during the calling window (weekdays between start_time and end_time, in the candidate’s local timezone). Setting retries_enabled to false disables retries but still permits the initial dial. max_retries and retry_window_days are DEPRECATED and no longer read.
Validation: end_time must be strictly greater than start_time, and weekdays must contain at least one entry. Violations return HTTP 400 with the offending field name in attr.
PATCH is a partial update. This resource is a singleton per organization: PUT, POST, and DELETE are not supported.
Fields:
retries_enabled(bool): master switch for retry attempts. When false, retries are skipped and only the initial dial is placed.max_retries(int): DEPRECATED, read-only — still returned, writes ignored. The retry budget is now the length ofretry_delay_sequence.retry_window_days(int): DEPRECATED, read-only — still returned, writes ignored.retry_delay_sequencenow bounds the campaign.start_time(HH:MM:SS): calling-window start, in the candidate’s local timezone.end_time(HH:MM:SS): calling-window end, in the candidate’s local timezone. Must be greater thanstart_time.weekdays(array of weekday names, lowercase): weekdays on which dials may be placed. Must not be empty.retry_delay_sequence(array of durations, format[D ]HH:MM:SS): delays between successive retries; one entry per retry, so the number of entries is the retry budget.
Authorizations
API key authentication for the public API. Pass your API key as a Bearer token.
Body
Org-wide outbound-call policy; all settings apply to phone interviews only.
Whether retries are enabled for failed phone interviews. If enabled, TalentUnveiled will automatically retry failed calls according to the policy defined in this model.
Daily start time for outbound calls, both the initial call and retries (e.g., 09:00). Timezone is determined by the applicant's phone number area code.
Daily end time for outbound calls, both the initial call and retries (e.g., 19:00). Timezone is determined by the applicant's phone number area code.
Weekdays when outbound calls can be made, both the initial call and retries.
monday- Mondaytuesday- Tuesdaywednesday- Wednesdaythursday- Thursdayfriday- Fridaysaturday- Saturdaysunday- Sunday
monday, tuesday, wednesday, thursday, friday, saturday, sunday [Retries enabled only] Sequence of delays between retry attempts. At least one entry is required when retries_enabled=true.
Response
Org-wide outbound-call policy; all settings apply to phone interviews only.
DEPRECATED, no longer read: the retry budget is now the length of retry_delay_sequence. Kept read-only as a rollback anchor.
DEPRECATED, no longer read: retry_delay_sequence now bounds the campaign. Kept read-only as a rollback anchor.
Whether retries are enabled for failed phone interviews. If enabled, TalentUnveiled will automatically retry failed calls according to the policy defined in this model.
Daily start time for outbound calls, both the initial call and retries (e.g., 09:00). Timezone is determined by the applicant's phone number area code.
Daily end time for outbound calls, both the initial call and retries (e.g., 19:00). Timezone is determined by the applicant's phone number area code.
Weekdays when outbound calls can be made, both the initial call and retries.
monday- Mondaytuesday- Tuesdaywednesday- Wednesdaythursday- Thursdayfriday- Fridaysaturday- Saturdaysunday- Sunday
monday, tuesday, wednesday, thursday, friday, saturday, sunday [Retries enabled only] Sequence of delays between retry attempts. At least one entry is required when retries_enabled=true.

