---
title: "[beta] Update Safety Events"
method: PATCH
path: "/safety-events/batch"
tags: ["Beta APIs"]
---

# \[beta\] Update Safety Events

`PATCH /safety-events/batch`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/safety-events/batch`
- Auth: HTTP bearer

Asynchronously update eventState, context labels, and/or behavior labels for one or more Safety Events. Returns 202 Accepted immediately. State changes propagate asynchronously; use GET /safety-events to confirm updated state. If any safetyEventIds are not found, the entire request fails with 404 before any mutations are executed.If both eventState and label fields are provided, the two mutations execute serially and are not transactional — a label mutation failure will not roll back a successful state change.

 <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select **Write Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

## Request body

- SafetyEventsV2PatchSafetyEventsV2BatchRequestBody: Request body for updating Safety Events. At least one of eventState, contextLabelsToAdd, contextLabelsToRemove, behaviorLabelsToAdd, or behaviorLabelsToRemove must be provided. Maximum 200 IDs per request.
  - `behaviorLabelsToAdd` string[]: Behavior labels to add to the Safety Events.
  - `behaviorLabelsToRemove` string[]: Behavior labels to remove from the Safety Events.
  - `contextLabelsToAdd` string[]: Context labels to add to the Safety Events.
  - `contextLabelsToRemove` string[]: Context labels to remove from the Safety Events.
  - `dismissalReason` PatchSafetyEventsDismissalReasonBodyRequestBody: Dismissal reason. Required when eventState is `dismissed`. Must not be provided for other states.
    - `code` 'incorrect' | 'minorEvent' | 'other', required: The dismissal reason code associated with the event. Valid values: `incorrect`, `minorEvent`, `other`
    - `comment` string: The dismissal reason comment associated with the event.
  - `eventState` 'needsReview' | 'reviewed' | 'needsCoaching' | 'coached' | 'dismissed' | 'needsRecognition' | 'recognized': The new state to apply to all specified Safety Events. Valid values: `needsReview`, `reviewed`, `needsCoaching`, `coached`, `dismissed`, `needsRecognition`, `recognized`
  - `safetyEventIds` string[], required: IDs of the Safety Events to update. Maximum 200.

## Response `202`

Accepted response.

- SafetyEventsV2PatchSafetyEventsV2BatchResponseBody
  - `requestId` string, required: Server-generated UUID for client-side correlation and logging. Not stored or queryable on the backend.
  - `responses` PatchSafetyEventsResponseItemResponseBody[], required: One entry per requested safetyEventId, in the same order as the request.
    - `data` PatchSafetyEventsResponseItemDataResponseBody, required: Data payload for a single Safety Event in the batch response.
      - `safetyEventId` string, required: The unique Samsara ID (uuid) of the safety event.
    - `status` integer, required: HTTP status code for this item. Always 202 on success.

## Other responses

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)