---
title: "Update Case"
method: PUT
path: "/incidents/v1/osha/cases/{case.case_id}"
tags: ["OSHA"]
---

# Update Case

`PUT /incidents/v1/osha/cases/{case.case_id}`

## Path parameters

- `case.case_id` string, required

## Request body

- S12IncidentsV1OSHAServiceUpdateCaseBody — UpdateCaseRequest is the request message for updating an OSHA case. If field_mask is set, only the fields specified will be updated (PATCH semantics). If field_mask is not set, all fields will be updated (PUT semantics).
  - `case` object — case contains the updated case data.
    - `establishment_id` string — establishment_id is the ID of the establishment this case belongs to.
    - `created_at` string, date-time — created_at is the timestamp when the case was created.
    - `modified_at` string, date-time — modified_at is the timestamp when the case was last modified.
    - `created_by` S12IncidentsV1UserMeta
      - `user_id` string — unique identifier for the user
      - `display_name` string — name of the user
      - `profile_image` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string — full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV' — - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `email` string — email address of the user
      - `seat_type` 'SUBSCRIPTION_SEAT_TYPE_UNSPECIFIED' | 'SUBSCRIPTION_SEAT_TYPE_PREMIUM' | 'SUBSCRIPTION_SEAT_TYPE_COLLABORATOR' | 'SUBSCRIPTION_SEAT_TYPE_LITE' | 'SUBSCRIPTION_SEAT_TYPE_SERVICE_USER' | 'SUBSCRIPTION_SEAT_TYPE_SUPPORT'
      - `status` 'USER_ACTIVE_STATUS_UNSPECIFIED' | 'USER_ACTIVE_STATUS_ACTIVE' | 'USER_ACTIVE_STATUS_DEACTIVATED' — - USER_ACTIVE_STATUS_UNSPECIFIED: Status is unknown or not specified - USER_ACTIVE_STATUS_ACTIVE: User is active - USER_ACTIVE_STATUS_DEACTIVATED: User has been deactivated
      - `timezone` string — the timezone of the user
    - `modified_by` S12IncidentsV1UserMeta
      - `user_id` string — unique identifier for the user
      - `display_name` string — name of the user
      - `profile_image` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string — full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV' — - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `email` string — email address of the user
      - `seat_type` 'SUBSCRIPTION_SEAT_TYPE_UNSPECIFIED' | 'SUBSCRIPTION_SEAT_TYPE_PREMIUM' | 'SUBSCRIPTION_SEAT_TYPE_COLLABORATOR' | 'SUBSCRIPTION_SEAT_TYPE_LITE' | 'SUBSCRIPTION_SEAT_TYPE_SERVICE_USER' | 'SUBSCRIPTION_SEAT_TYPE_SUPPORT'
      - `status` 'USER_ACTIVE_STATUS_UNSPECIFIED' | 'USER_ACTIVE_STATUS_ACTIVE' | 'USER_ACTIVE_STATUS_DEACTIVATED' — - USER_ACTIVE_STATUS_UNSPECIFIED: Status is unknown or not specified - USER_ACTIVE_STATUS_ACTIVE: User is active - USER_ACTIVE_STATUS_DEACTIVATED: User has been deactivated
      - `timezone` string — the timezone of the user
    - `year_of_filing` integer — year_of_filing is the year this case is filed for.
    - `case_number` string — case_number is the case number.
    - `job_title` string — job_title is the job title of the affected employee.
    - `date_of_incident` string, date-time — date_of_incident is the date the incident occurred.
    - `incident_location` string — incident_location is where the incident occurred.
    - `incident_description` string — incident_description is description of the incident.
    - `incident_outcome` integer — incident_outcome is the outcome of the incident (1=Death, 2=Days away, 3=Job transfer, 4=Other).
    - `dafw_num_away` integer — dafw_num_away is days away from work.
    - `djtr_num_tr` integer — djtr_num_tr is days job transfer or restriction.
    - `type_of_incident` integer — type_of_incident is the type of incident (1=Injury, 2=Skin disorder, 3=Respiratory, 4=Poisoning, 5=Hearing loss, 6=Other).
    - `date_of_birth` string, date-time — date_of_birth is the employee's date of birth.
    - `date_of_hire` string, date-time — date_of_hire is the employee's date of hire.
    - `sex` string — sex is the employee's sex (M or F).
    - `treatment_facility_type` integer — treatment_facility_type is whether emergency room was used (1=yes, 0=no).
    - `treatment_in_patient` integer — treatment_in_patient is whether hospitalization was required (1=yes, 0=no).
    - `time_started_work` string — time_started_work is time employee began work (hh:mm format).
    - `time_of_incident` string — time_of_incident is time of incident (hh:mm format).
    - `time_unknown` boolean — time_unknown is whether time of incident is unknown.
    - `nar_before_incident` string — nar_before_incident is what employee was doing before incident.
    - `nar_what_happened` string — nar_what_happened is how injury/illness occurred.
    - `nar_injury_illness` string — nar_injury_illness is what the injury/illness was.
    - `nar_object_substance` string — nar_object_substance is object/substance that harmed employee.
    - `date_of_death` string, date-time — date_of_death is the date of death if applicable.
    - `employee_name` string — employee_name is the name of the employee.
    - `employee_street_address` string — employee_street_address is the street address of the employee.
    - `employee_city` string — employee_city is the city where the employee resides.
    - `employee_state` string — employee_state is the two-letter state code for the employee.
    - `employee_zip` string — employee_zip is the ZIP code for the employee.
    - `physician_name` string — physician_name is the name of the physician who treated the employee.
    - `facility_name` string — facility_name is the name of the treatment facility.
    - `facility_street_address` string — facility_street_address is the street address of the treatment facility.
    - `facility_city` string — facility_city is the city where the treatment facility is located.
    - `facility_state` string — facility_state is the two-letter state code for the treatment facility.
    - `facility_zip` string — facility_zip is the ZIP code for the treatment facility.
  - `field_mask` string — field_mask specifies which fields to update. If not set, all fields will be updated.

## Response `200`

A successful response.

- S12IncidentsV1UpdateCaseResponse — UpdateCaseResponse is the response message for updating an OSHA case.
  - `case` S12IncidentsV1Case — Case represents an OSHA case record.
    - `case_id` string — case_id is the unique identifier for the case.
    - `establishment_id` string — establishment_id is the ID of the establishment this case belongs to.
    - `created_at` string, date-time — created_at is the timestamp when the case was created.
    - `modified_at` string, date-time — modified_at is the timestamp when the case was last modified.
    - `created_by` S12IncidentsV1UserMeta
      - `user_id` string — unique identifier for the user
      - `display_name` string — name of the user
      - `profile_image` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string — full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV' — - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `email` string — email address of the user
      - `seat_type` 'SUBSCRIPTION_SEAT_TYPE_UNSPECIFIED' | 'SUBSCRIPTION_SEAT_TYPE_PREMIUM' | 'SUBSCRIPTION_SEAT_TYPE_COLLABORATOR' | 'SUBSCRIPTION_SEAT_TYPE_LITE' | 'SUBSCRIPTION_SEAT_TYPE_SERVICE_USER' | 'SUBSCRIPTION_SEAT_TYPE_SUPPORT'
      - `status` 'USER_ACTIVE_STATUS_UNSPECIFIED' | 'USER_ACTIVE_STATUS_ACTIVE' | 'USER_ACTIVE_STATUS_DEACTIVATED' — - USER_ACTIVE_STATUS_UNSPECIFIED: Status is unknown or not specified - USER_ACTIVE_STATUS_ACTIVE: User is active - USER_ACTIVE_STATUS_DEACTIVATED: User has been deactivated
      - `timezone` string — the timezone of the user
    - `modified_by` S12IncidentsV1UserMeta
      - `user_id` string — unique identifier for the user
      - `display_name` string — name of the user
      - `profile_image` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string — full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV' — - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `email` string — email address of the user
      - `seat_type` 'SUBSCRIPTION_SEAT_TYPE_UNSPECIFIED' | 'SUBSCRIPTION_SEAT_TYPE_PREMIUM' | 'SUBSCRIPTION_SEAT_TYPE_COLLABORATOR' | 'SUBSCRIPTION_SEAT_TYPE_LITE' | 'SUBSCRIPTION_SEAT_TYPE_SERVICE_USER' | 'SUBSCRIPTION_SEAT_TYPE_SUPPORT'
      - `status` 'USER_ACTIVE_STATUS_UNSPECIFIED' | 'USER_ACTIVE_STATUS_ACTIVE' | 'USER_ACTIVE_STATUS_DEACTIVATED' — - USER_ACTIVE_STATUS_UNSPECIFIED: Status is unknown or not specified - USER_ACTIVE_STATUS_ACTIVE: User is active - USER_ACTIVE_STATUS_DEACTIVATED: User has been deactivated
      - `timezone` string — the timezone of the user
    - `year_of_filing` integer — year_of_filing is the year this case is filed for.
    - `case_number` string — case_number is the case number.
    - `job_title` string — job_title is the job title of the affected employee.
    - `date_of_incident` string, date-time — date_of_incident is the date the incident occurred.
    - `incident_location` string — incident_location is where the incident occurred.
    - `incident_description` string — incident_description is description of the incident.
    - `incident_outcome` integer — incident_outcome is the outcome of the incident (1=Death, 2=Days away, 3=Job transfer, 4=Other).
    - `dafw_num_away` integer — dafw_num_away is days away from work.
    - `djtr_num_tr` integer — djtr_num_tr is days job transfer or restriction.
    - `type_of_incident` integer — type_of_incident is the type of incident (1=Injury, 2=Skin disorder, 3=Respiratory, 4=Poisoning, 5=Hearing loss, 6=Other).
    - `date_of_birth` string, date-time — date_of_birth is the employee's date of birth.
    - `date_of_hire` string, date-time — date_of_hire is the employee's date of hire.
    - `sex` string — sex is the employee's sex (M or F).
    - `treatment_facility_type` integer — treatment_facility_type is whether emergency room was used (1=yes, 0=no).
    - `treatment_in_patient` integer — treatment_in_patient is whether hospitalization was required (1=yes, 0=no).
    - `time_started_work` string — time_started_work is time employee began work (hh:mm format).
    - `time_of_incident` string — time_of_incident is time of incident (hh:mm format).
    - `time_unknown` boolean — time_unknown is whether time of incident is unknown.
    - `nar_before_incident` string — nar_before_incident is what employee was doing before incident.
    - `nar_what_happened` string — nar_what_happened is how injury/illness occurred.
    - `nar_injury_illness` string — nar_injury_illness is what the injury/illness was.
    - `nar_object_substance` string — nar_object_substance is object/substance that harmed employee.
    - `date_of_death` string, date-time — date_of_death is the date of death if applicable.
    - `employee_name` string — employee_name is the name of the employee.
    - `employee_street_address` string — employee_street_address is the street address of the employee.
    - `employee_city` string — employee_city is the city where the employee resides.
    - `employee_state` string — employee_state is the two-letter state code for the employee.
    - `employee_zip` string — employee_zip is the ZIP code for the employee.
    - `physician_name` string — physician_name is the name of the physician who treated the employee.
    - `facility_name` string — facility_name is the name of the treatment facility.
    - `facility_street_address` string — facility_street_address is the street address of the treatment facility.
    - `facility_city` string — facility_city is the city where the treatment facility is located.
    - `facility_state` string — facility_state is the two-letter state code for the treatment facility.
    - `facility_zip` string — facility_zip is the ZIP code for the treatment facility.

## 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)