Create or update event

POST

/events

curl --request POST \
  --url https://safe-api.safetyradar.com/v2/events \
  --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" }'

• Production

Create a new event or update an existing one. Without id, matches by externalId (upsert). With id, looks up the event and can rename its externalId.

Authorizations

• Bearer

Request Body^required

Media typeapplication/json

object

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

>= 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

required

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

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"
    }
  }
}

201

Event created

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

Unauthorized

Media typeapplication/json

object

code

required

string

message

required

string

details

object

key

additional properties

nullable

Example^generated

{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

404

Event not found (when id is provided but does not match an event in this org)

Media typeapplication/json

object

code

required

string

message

required

string

details

object

key

additional properties

nullable

Example^generated

{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

409

ExternalId already in use by another event

Media typeapplication/json

object

code

required

string

message

required

string

details

object

key

additional properties

nullable

Example^generated

{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}