Skip to content
Safety RadarSafety RadarSafety Radar Docs

Update event

PUT
/events/{eventId}
curl --request PUT \
  --url https://safe-api.safetyradar.com/v2/events/123e4567-e89b-12d3-a456-426614174000 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "externalId": "example", "type": "example", "title": "example", "eventDate": "2026-05-19T14:23:00.000Z", "reportDate": "example", "address1": "example", "address2": "example", "city": "example", "state": "example", "zip": "example", "latitude": 1, "longitude": 1, "description": "example", "ownerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "reportedBy": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "locationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "statusId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "actionTaken": "example", "metadata": { "additionalProperty": "example" }, "media": [ "example" ], "metricData": { "additionalProperty": "example" }, "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "locationExternalId": "example", "ownerExternalId": "example", "reportedByExternalId": "example", "statusExternalId": "example" }'

Update an existing event by UUID or external ID. Returns 404 if event does not exist.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
eventId
required

Event ID (UUID) or external ID

string
Example
123e4567-e89b-12d3-a456-426614174000

Event ID (UUID) or external ID

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
externalId
string
type
string
title
string
eventDate

Event date and time in UTC. Accepts a full ISO 8601 timestamp (e.g. “2026-05-19T14:23:00Z”) or a date-only string (“2026-05-19”); date-only inputs are anchored at 08:00 UTC for backwards compatibility.

string format: date-time
>= 1 characters
Example
2026-05-19T14:23:00.000Z
reportDate
string
nullable
address1
string
nullable
address2
string
nullable
city
string
nullable
state
string
nullable
zip
string
nullable
latitude
number
nullable >= -140737488355328 <= 140737488355327
longitude
number
nullable >= -140737488355328 <= 140737488355327
description
string
ownerId
string format: uuid
nullable
reportedBy
string format: uuid
nullable
locationId
string format: uuid
nullable
statusId
string format: uuid
nullable
actionTaken
string
nullable
metadata
object
key
additional properties
nullable
media
Array<string>
metricData
object
key
additional properties
nullable
id
string format: uuid
locationExternalId
string
ownerExternalId
string
reportedByExternalId
string
statusExternalId
string

Responses

Section titled “Responses”

200

Section titled “200”

Event updated

Media typeapplication/json
object
data
required
object
id
required
string format: uuid
organizationId
required
string format: uuid
externalId
required
string
type
required
string
title
required
string
eventDate
required

Event date and time in UTC. Accepts a full ISO 8601 timestamp (e.g. “2026-05-19T14:23:00Z”) or a date-only string (“2026-05-19”); date-only inputs are anchored at 08:00 UTC for backwards compatibility.

string format: date-time
reportDate
required
string
nullable
address1
required
string
nullable
address2
required
string
nullable
city
required
string
nullable
state
required
string
nullable
zip
required
string
nullable
latitude
required
number
nullable >= -140737488355328 <= 140737488355327
longitude
required
number
nullable >= -140737488355328 <= 140737488355327
description
required
string
ownerId
required
string format: uuid
nullable
reportedBy
required
string format: uuid
nullable
locationId
required
string format: uuid
nullable
statusId
required
string format: uuid
nullable
actionTaken
required
string
nullable
metadata
required
object
key
additional properties
nullable
media
required
Array<string>
nullable
metricData
required
object
key
additional properties
nullable
trainingMetadata
required
Array<object>
nullable
object
name
required
string
value
required
string
tag
required
string
embeddingsBatchStatus
required
string
nullable
createdAt
required
string
updatedAt
required
string
deletedAt
required
string
nullable
location
required
object
id
required
string format: uuid
organizationId
required
string format: uuid
name
required
string
description
required
string
nullable
slug
required
string
address1
required
string
nullable
address2
required
string
nullable
city
required
string
nullable
state
required
string
nullable
zip
required
string
nullable
latitude
required
number
nullable >= -140737488355328 <= 140737488355327
longitude
required
number
nullable >= -140737488355328 <= 140737488355327
status
required
string
Allowed values: active inactive
type
required
string
Allowed values: equipment location
parentId
required
string format: uuid
nullable
externalId
required
string
nullable
createdById
required
string format: uuid
nullable
lastEditedById
required
string format: uuid
nullable
searchText
nullable
createdAt
required
string
updatedAt
required
string
deletedAt
required
string
nullable
parentExternalId
required
string
nullable
owner
required
object
id
required
string format: uuid
fullName
required
string
nullable
email
required
string
avatarUrl
required
string
nullable
status
required
object
id
required
string format: uuid
slug
required
string
externalId
required
string
nullable
organizationId
required
string format: uuid
name
required
string
description
required
string
nullable
isSystem
required
boolean
group
required
string
nullable
Allowed values: new in_progress complete on_hold cancelled
color
required
string
nullable
orderIndex
required
integer
nullable >= -2147483648 <= 2147483647
createdById
required
string format: uuid
nullable
createdAt
required
string
updatedAt
required
string
deletedAt
required
string
nullable
Example
{
  "data": {
    "eventDate": "2026-05-19T14:23:00.000Z",
    "location": {
      "status": "active",
      "type": "equipment"
    },
    "status": {
      "group": "new"
    }
  }
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
code
required
string
message
required
string
details
object
key
additional properties
nullable
Examplegenerated
{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

404

Section titled “404”

Event not found

Media typeapplication/json
object
code
required
string
message
required
string
details
object
key
additional properties
nullable
Examplegenerated
{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

409

Section titled “409”

ExternalId already in use by another event

Media typeapplication/json
object
code
required
string
message
required
string
details
object
key
additional properties
nullable
Examplegenerated
{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}