> ## Documentation Index > Fetch the complete documentation index at: https://docs.talentunveiled.com/llms.txt > Use this file to discover all available pages before exploring further. # Get the interview schedule config > GET/PATCH /jobs/{job_id}/interview-config/schedule. The schedule row is auto-created with the config, so it always exists once the config does; there is no separate create. PATCH updates it in place. ## OpenAPI ````yaml /swagger/v2_schema.yaml get /jobs/{job_id}/interview-config/schedule openapi: 3.0.3 info: title: TalentUnveiled API v2 version: 2.0.0 description: >- Public API v2 for managing jobs, applications, interviews, and webhooks. **Pagination:** list endpoints return a `{count, next, previous, results}` envelope. Page with the `limit` and `offset` query parameters; `limit` defaults to 50 and is capped at 200. servers: - url: https://api.talentunveiled.com/api/v2 description: Production server security: [] tags: - name: Meta description: Identify the organization an API key belongs to. - name: Jobs description: Create, read, update, and archive job postings. - name: Applications description: Create applications and track them through the pipeline. - name: Interview Configuration description: The interview config and call schedule for a job. - name: Interview Criteria description: Evaluation criteria for a job's interview. - name: Interview Questions description: Questions asked during a job's interview. - name: Interview Results description: The scored interview result for an application. - name: Interview Calls description: Call attempts, scheduling, and transcripts. - name: CV Evaluations description: AI scoring of a candidate's CV against the job. - name: Insights description: Combined CV and interview insights for an application. - name: Webhooks description: Manage webhook subscriptions and inspect deliveries. - name: Hiring Team description: Manage the hiring team assigned to a job posting. - name: Members description: List the members of the organization. paths: /jobs/{job_id}/interview-config/schedule: get: tags: - Interview Configuration summary: Get the interview schedule config description: >- GET/PATCH /jobs/{job_id}/interview-config/schedule. The schedule row is auto-created with the config, so it always exists once the config does; there is no separate create. PATCH updates it in place. operationId: jobs_interview_config_schedule_retrieve parameters: - in: path name: job_id schema: type: string format: uuid required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/InterviewScheduleConfig' description: '' '401': description: Authentication credentials were not provided or are invalid. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: The requested resource does not exist. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKeyAuth: [] components: schemas: InterviewScheduleConfig: type: object properties: id: type: string format: uuid readOnly: true created_at: type: string format: date-time readOnly: true updated_at: type: string format: date-time readOnly: true enabled: type: boolean description: >- Whether interview scheduling is enabled. When enabled, application creation requires scheduled_at and the interview starts at that slot instead of immediately; applications created without a slot (recruiter invite, ATS sync) are not auto-started. When disabled, the interview starts directly. scheduling_horizon_days: type: integer maximum: 2147483647 minimum: 0 description: >- [Scheduling enabled only] Number of days in the future that candidates can schedule their interviews. available_weekdays: type: array items: $ref: '#/components/schemas/WeekdayEnum' description: >- [Scheduling enabled only] Weekdays when candidates can schedule interviews. At least one is required when enabled=true. start_time: type: string format: time description: >- [Scheduling enabled only] Daily start time for interview scheduling (e.g., 08:00). Timezone is determined by the applicant's phone number area code. end_time: type: string format: time description: >- [Scheduling enabled only] Daily end time for interview scheduling (e.g., 19:00). Timezone is determined by the applicant's phone number area code. minimum_notice_hours: type: integer maximum: 2147483647 minimum: 0 nullable: true description: >- [Scheduling enabled only] Minimum number of hours of notice required for candidates to schedule an interview. required: - created_at - id - updated_at ErrorResponse: type: array description: List of errors items: $ref: '#/components/schemas/ErrorItem' WeekdayEnum: enum: - monday - tuesday - wednesday - thursday - friday - saturday - sunday type: string description: |- * `monday` - Monday * `tuesday` - Tuesday * `wednesday` - Wednesday * `thursday` - Thursday * `friday` - Friday * `saturday` - Saturday * `sunday` - Sunday ErrorItem: type: object description: Individual error item properties: code: allOf: - $ref: '#/components/schemas/ErrorCodeEnum' description: Machine-readable error code detail: type: string description: Human-readable error message attr: type: string nullable: true description: Field name this error relates to (for validation errors) required: - code - detail ErrorCodeEnum: type: string enum: - error - invalid_input - parse_error - authentication_failed - not_authenticated - permission_denied - not_found - method_not_allowed - not_acceptable - unsupported_media_type - throttled - required - does_not_exist - incorrect_type - no_match - incorrect_match - not_a_list - not_a_dict - empty - candidate_user_mismatch - candidate_not_found - cross_organization_application - already_exists - call_service_error - call_not_joinable - call_config_error - call_access_denied - call_already_linked - date_range_too_large - date_range_start_after_end - invalid_date - language_not_configured - vapi_api_error - webhook_processing_error - proxy_error - configuration_error - interview_call_already_processed - call_type_switch_error - slot_in_past - interview_not_scheduled - interview_opt_out_not_eligible - interview_retry_not_allowed - retake_limit_reached - interview_session_not_joinable - interview_session_retake_not_eligible - interview_session_already_processing - interview_session_not_completed - interview_session_reset_not_allowed - interview_mode_locked - application_already_exists - gateway_verification_failed - invalid_file_type - file_too_large - cv_already_exists - cv_required - custom_fields_too_large - nylas_grant_already_exists - nylas_upstream_error - otp_challenge_not_found - job_posting_not_found - job_application_not_found - workflow_execution_error - llm_generation_failed - report_generation_failed - interview_config_has_no_criteria - scheduling_not_enabled - interview_session_not_reschedulable - interview_version_mismatch - v3_job_missing_config - idempotency_key_conflict - idempotency_key_invalid - application_status_transition_invalid - application_state_conflict - external_id_conflict - qualification_cannot_have_score - competency_requires_bars description: Machine-readable error code securitySchemes: apiKeyAuth: type: http scheme: bearer description: >- API key authentication for the public API. Pass your API key as a Bearer token. ````