---
title: "Update Contact"
method: PATCH
path: "/v1/interviews/{interview_id}/contacts/{contact_id}"
tags: ["interviews"]
---

# Update Contact

`PATCH /v1/interviews/{interview_id}/contacts/{contact_id}`

Partially update a contact's profile fields (name, email, role, etc.).

Does not change scheduling state, booking_token, or status — those are
managed by the start/reschedule/follow-up endpoints.

## Path parameters

- `interview_id` string, uuid, required
- `contact_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Request body

- ContactUpdate — Partial update for an existing contact. Only fields explicitly set are written. `is_required` is included as `bool | None` so unset means "leave alone"; pass `false`/`true` to flip it.
  - `name` string, nullable
  - `email` string, nullable
  - `slack_user_id` string, nullable
  - `slack_team_id` string, nullable
  - `phone` string, nullable
  - `job_title` string, nullable
  - `department` string, nullable
  - `seniority_level` integer, nullable
  - `is_required` boolean, nullable

## Response `200`

Successful Response

- AppApiInterviewSchemasContactOut
  - `id` string, uuid, required
  - `interview_id` string, uuid, required
  - `person_id` string, uuid, nullable
  - `question_set_id` string, uuid, nullable, required
  - `name` string, required
  - `email` string, nullable, required
  - `slack_user_id` string, nullable
  - `slack_team_id` string, nullable
  - `slack_dm_channel_id` string, nullable
  - `phone` string, nullable, required
  - `job_title` string, nullable, required
  - `department` string, nullable, required
  - `seniority_level` integer, nullable, required
  - `is_required` boolean, required
  - `meeting_url` string, nullable, required
  - `booking_token` string, nullable
  - `status` string, required
  - `reminder_count` integer
  - `last_reminder_at` string, date-time, nullable
  - `reinvited_from_contact_id` string, uuid, nullable
  - `booking_token_expires_at` string, date-time, nullable
  - `invitation_status` string
  - `scheduled_at` string, date-time, nullable, required
  - `completed_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `scheduled_session_status` string, nullable
  - `scheduled_session_available_at` string, date-time, nullable
  - `scheduled_session_started_at` string, date-time, nullable
  - `scheduled_session_expires_at` string, date-time, nullable
  - `delivery_failure_reason` string, nullable
  - `delivery_failure_at` string, date-time, nullable
  - `last_accessed_at` string, date-time, nullable
  - `session_accessibility_message` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)