---
title: "Update an interview request"
method: PATCH
path: "/interviews/{id}"
tags: ["Interviews"]
---

# Update an interview request

`PATCH /interviews/{id}`

## Request

- Base URL: `https://app.usehindsight.com/api/v1`
- URL: `https://app.usehindsight.com/api/v1/interviews/{id}`
- Auth: HTTP bearer

Updates context on an existing interview request. Accepts any combination of
`contact_context`, `contact_name`, and `objective`. At least one field must be provided.

- `contact_context` and `contact_name` update the contact record associated with the request.
  Context is stored in the contact's notes field and used by Paige in every future interview prompt for that contact.
- `objective` updates the interview-specific goal on the request itself.

## Path parameters

- `id` integer, required

## Request body

- UpdateInterviewRequest
  - `contact_context` union: Updated context about the contact. Overwrites the existing contact notes. Used by Paige as background in every future interview prompt for this contact.
    - string
    - object
  - `contact_name` string: Updated display name for the contact.
  - `objective` string: Updated goal for this specific interview.

## Response `200`

Interview request updated

- UpdateInterviewResponse
  - `interview_request_id` integer: ID of the updated interview request.

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - invalid or missing API key
- `404`: Interview request not found
- `429`: Too many requests - rate limit or applicable usage quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/usehindsight/apis/hindsight-api.md) - [All operations](https://skmtc.dev/usehindsight/apis/hindsight-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usehindsight/apis/hindsight-api/revisions/97371a7da857?raw)