---
title: "Update Custom Field Values"
method: PUT
path: "/incidents/{id}/custom_fields/values"
tags: ["Incidents"]
---

# Update Custom Field Values

`PUT /incidents/{id}/custom_fields/values`

Set custom field values for an incident.

Scoped OAuth requires: `incidents.write`

## Path parameters

- `id` string, required

## Request body

- object
  - `custom_fields` CustomFieldsEditableFieldValue[], required
    - union
      - object
        - `name` Name — unresolved $ref
        - `value` union
          - 0 — unresolved $ref
          - 1 — unresolved $ref
          - 2 — unresolved $ref
          - 3 — unresolved $ref
          - 4 — unresolved $ref
          - 5 — unresolved $ref
      - object
        - `id` string — The ID of the Field.
        - `value` union
          - 0 — unresolved $ref
          - 1 — unresolved $ref
          - 2 — unresolved $ref
          - 3 — unresolved $ref
          - 4 — unresolved $ref
          - 5 — unresolved $ref

## Response `201`

Custom field values were updated.

- object
  - `custom_fields` CustomFieldsFieldValue[], required
    - `id` string, required — Id of the field.
    - `name` string, required — The name of the field. May include ASCII characters, specifically lowercase letters, digits, and underescores. The `name` for a Field must be unique and cannot be changed once created.
    - `type` 'field_value', required — Determines the type of the reference.
    - `display_name` string, required — The human-readable name of the field. This must be unique across an account.
    - `field_type` 'single_value' | 'single_value_fixed' | 'multi_value' | 'multi_value_fixed', required — The type of data this field contains. In combination with the `data_type` field.
    - `data_type` 'boolean' | 'integer' | 'float' | 'string' | 'datetime' | 'url', required — The kind of data the custom field is allowed to contain.
    - `description` string, nullable, required — A description of the data this field contains.
    - `value` union, required
      - object
        - `value` boolean, nullable
      - object
        - `value` number, nullable
      - object
        - `value` integer, nullable
      - object
        - `value` union
          - string, nullable
          - string[], nullable
      - object
        - `value` string, date-time, nullable
      - object
        - `value` string, uri, nullable

## Other responses

- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `404` — The requested resource was not found.
- `500` — Internal Server Error the PagerDuty server experienced an error.

---

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