---
title: "Update inquiry by id"
method: PATCH
path: "/v2/inquiries/{id}"
tags: ["Inquiries"]
---

# Update inquiry by id

`PATCH /v2/inquiries/{id}`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/inquiries/{id}`
- Auth: API key in header `x-api-key`

Change an inquiry, for example to update its status.

## Path parameters

- `id` string, uuid

## Request body

- PatchV2InquiriesIdRequestBody
  - `resolutionType` string, nullable
  - `response` string, nullable
  - `status` 'new' | 'pending_resolution' | 'unresolved' | 'resolved' | 'appointment_scheduled' | 'duplicate'
  - `notes` string, nullable

## Response `200`

PATCH /v2/inquiries/:id Positive response

- PatchV2InquiriesIdPositiveResponse
  - `id` string, uuid, required
  - `createdAt` string, date-time, nullable, required: Inquiry creation time. ISO 8601 timestamp
  - `updatedAt` string, date-time, nullable, required: Inquiry last update time. ISO 8601 timestamp
  - `customerCampaignId` string, uuid, required
  - `callId` string, uuid, nullable, required
  - `toolCallId` string, nullable, required
  - `duplicateOfId` string, uuid, nullable, required
  - `inquiry` string, required
  - `response` string, nullable, required
  - `status` 'new' | 'pending_resolution' | 'unresolved' | 'resolved' | 'appointment_scheduled' | 'duplicate', required
  - `primaryCategory` string, nullable, required
  - `subcategory` string, nullable, required
  - `severity` string, nullable, required
  - `severityTriggers` union, required
    - string
    - number
    - boolean
    - object
    - unknown[]
      - unknown
  - `priority` integer, nullable, required
  - `priorityRationale` string, nullable, required
  - `priorityCategory` string, nullable, required
  - `priorityConfidence` integer, nullable, required
  - `priorityRank` integer, nullable, required
  - `suggestedHandling` string, nullable, required
  - `handlingRationale` string, nullable, required
  - `reasoning` string, nullable, required
  - `escalationApplied` boolean, nullable, required
  - `additionalConcerns` union, required
    - string
    - number
    - boolean
    - object
    - unknown[]
      - unknown
  - `resolutionType` string, nullable, required
  - `notes` string, nullable, required
  - `resolvedAt` string, date-time, nullable, required: Inquiry resolution time. ISO 8601 timestamp
  - `resolvedBy` string, uuid, nullable, required
  - `assignedTo` string, uuid, nullable, required
  - `callbackRequestedAt` string, date-time, nullable, required: Callback request time. ISO 8601 timestamp
  - `callbackRequestedBy` string, uuid, nullable, required
  - `callbackWorkflowId` string, uuid, nullable, required
  - `callbackCompletedAt` string, date-time, nullable, required: Callback completion time. ISO 8601 timestamp
  - `callbackCallId` string, uuid, nullable, required
  - `callbackDisposition` string, nullable, required
  - `callbackFailureReason` string, nullable, required
  - `callbackScheduledFor` string, date-time, nullable, required: Scheduled callback time. ISO 8601 timestamp

## Other responses

- `400`: PATCH /v2/inquiries/:id Negative response 400
- `401`: PATCH /v2/inquiries/:id Negative response 401
- `403`: PATCH /v2/inquiries/:id Negative response 403
- `404`: PATCH /v2/inquiries/:id Negative response 404
- `409`: PATCH /v2/inquiries/:id Negative response 409
- `422`: PATCH /v2/inquiries/:id Negative response 422
- `429`: PATCH /v2/inquiries/:id Negative response 429
- `500`: PATCH /v2/inquiries/:id Negative response 500
- `502`: PATCH /v2/inquiries/:id Negative response 502
- `503`: PATCH /v2/inquiries/:id Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)