---
title: "Update a request and optionally add a note"
method: PATCH
path: "/requests/{request}"
tags: ["Requests"]
---

# Update a request and optionally add a note

`PATCH /requests/{request}`

## Request

- Base URL: `https://helpspot.example.com/api/v2`
- URL: `https://helpspot.example.com/api/v2/requests/{request}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

## Path parameters

- `request` integer, required

## Request body

- UpdateRequestRequest
  - `note` string, nullable
  - `changed_at` integer
  - `note_type` integer
  - `note_is_html` boolean
  - `reporting_tags` string[]
  - `title` string
  - `acting_staff_id` integer
  - `assigned_staff_id` integer
  - `open` boolean
  - `status_id` integer
  - `category_id` integer
  - `customer_id` string, nullable
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, email, nullable
  - `phone` string, nullable
  - `urgent` boolean
  - `skip_reopen` boolean
  - `skip_custom_checks` boolean
  - `email_from_mailbox_id` integer
  - `email_cc` string, nullable
  - `email_bcc` string, nullable
  - `email_to` string, nullable
  - `notify_staff_ids` integer[]
  - `custom_fields` string[]
  - `attachments` object[]
    - `filename` string, required
    - `mime_type` string, required
    - `content_base64` string, required

## Response `200`

Request resource. Fields depend on visibility and endpoint; see the Requests guide.

- object
  - `data` RequestResource, required
    - `id` integer
    - `title` string, nullable
    - `customer_id` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `category_id` integer, nullable
    - `status_id` integer, nullable
    - `assigned_staff_id` integer, nullable
    - `opened_by_staff_id` integer, nullable
    - `portal_id` integer, nullable
    - `opened_via` integer
    - `opened_via_id` integer, nullable
    - `email_from_mailbox_id` integer, nullable
    - `open` boolean
    - `urgent` boolean
    - `trashed` boolean
    - `opened_at` string, date-time, nullable
    - `closed_at` string, date-time, nullable
    - `trashed_at` string, date-time, nullable
    - `last_reply_by_staff_id` integer, nullable
    - `time_total_seconds` integer
    - `unread` boolean
    - `summary` string, nullable
    - `access_key` string, nullable
    - `ai_summary` string, nullable
    - `out_of_office_detected` boolean
    - `auto_categorized` boolean
    - `custom_fields` object[]
      - `id` integer, required
      - `value` union, required
        - string
        - integer
        - boolean
    - `history` object[]
      - `id` integer
      - `request_id` integer
      - `author_id` integer
      - `created_at` string, date-time, nullable
      - `body_html` string, nullable
      - `public` boolean
      - `initial` boolean
      - `pinned` boolean
      - `external` boolean
      - `attachments` object[]
        - `id` integer
        - `filename` string, nullable
        - `mime_type` string, nullable
        - `content_id` string, nullable
        - `public_url` string, nullable
        - `private_url` string, nullable
    - `reporting_tags` object[]
      - `id` integer
      - `name` string
    - `subscriber_ids` integer[]
    - `survey_responses` object[]
      - `survey_id` integer
      - `name` string, nullable
      - `scoring_type` string, nullable
      - `score` integer, nullable
      - `comment` string, nullable
      - `responded_at` string, date-time, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `406`: Not Acceptable
- `409`: Conflict
- `413`: Content Too Large
- `422`: Validation error
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/helpspot/apis/helpspot-api-v2.md) · [All operations](https://skmtc.dev/helpspot/apis/helpspot-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/helpspot/apis/helpspot-api-v2/revisions/794dac0002c0?raw)