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

# Update Fields

`PUT /incidents/v1/fields`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/incidents/v1/fields`
- Auth: HTTP bearer

## 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.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
