---
title: "Update Fields"
method: PUT
path: "/incidents/v1/fields"
tags: ["Investigations"]
---

# Update Fields

`PUT /incidents/v1/fields`

## Request body

- S12IncidentsV1UpdateFieldsRequest
  - `fields` S12IncidentsV1UpsertableField[] — The set of fields to set for the organisation
    - `field_id` string — optional. the field id to update. a new field will be created if unset
    - `title` string — required. the title to display for the field
    - `text` S12IncidentsV1TextFieldSpec
      - `default_text` string — The default text to set as the content when instances of this field are created
  - `category_id` string — required. The category to update fields for

## Response `200`

A successful response.

- S12IncidentsV1UpdateFieldsResponse
  - `results` S12IncidentsV1FieldListItem[] — The updated field list
    - `field_id` string — unique identifier for the field
    - `created_at` string, date-time — created timestamp for the field
    - `modified_at` string, date-time — last modified timestamp for the field
    - `title` string — title of the field
    - `category_id` string — the category this field is associated with
    - `text` S12IncidentsV1TextFieldSpec
      - `default_text` string — The default text to set as the content when instances of this field are created

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)