Update an incident
const url = 'https://app.bluelightmaps.com/api/incidents/1';const options = { method: 'PUT', headers: {Authorization: 'Basic <credentials>', 'Content-Type': 'application/json'}, body: '{"id":1,"originId":"example","type":"example","timeOfOrigin":"2026-04-15T12:00:00Z","timeReceived":"2026-04-15T12:00:00Z","timeUpdated":"2026-04-15T12:00:00Z","status":"OPEN","latitude":1,"longitude":1,"priority":1,"description":"example","resources":["example"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://app.bluelightmaps.com/api/incidents/1 \ --header 'Authorization: Basic <credentials>' \ --header 'Content-Type: application/json' \ --data '{ "id": 1, "originId": "example", "type": "example", "timeOfOrigin": "2026-04-15T12:00:00Z", "timeReceived": "2026-04-15T12:00:00Z", "timeUpdated": "2026-04-15T12:00:00Z", "status": "OPEN", "latitude": 1, "longitude": 1, "priority": 1, "description": "example", "resources": [ "example" ] }'Update an incident by its database ID. Behaves exactly like PUT /incidents/update (a full replacement; the resources list is diffed and added / removed callsigns get incidentAssigned / incidentDeassigned events and pushes, and one callsign may resolve to several devices, each of which is notified), keyed on the path id instead of originId.
The same status rules apply: CLOSED stamps timeClosed, empties resources and stands every remaining callsign down with incidentStatus: CLOSED on the event; OPEN reopens the incident and clears timeClosed; an unknown status is a 400; and a non-empty resources array on a closed incident is a 409. timeClosed in the body is ignored.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Request Body required
Section titled “Request Body required ”object
Unique external identifier for the incident
Type of incident
Time when the incident occurred
Time when the incident was received by the system
Time when the incident was last updated
Lifecycle state. Incidents are created OPEN; status in a create body is ignored. On an update, omit it to keep the stored value, send CLOSED to close (which stands every remaining callsign down and stamps timeClosed) or OPEN to reopen (which clears timeClosed). Any other value is a 400, and assigning resources while closed is a 409.
When the incident was closed; absent (null) while it is open. Server-owned: set when status becomes CLOSED, cleared when it goes back to OPEN, and ignored if sent in a request body.
Latitude of the incident location
Longitude of the incident location
Priority of the incident
Description of the incident
Callsigns assigned to this incident. A callsign is matched against the names of the devices the caller can reach, and one callsign may map to several devices (a vehicle often carries more than one) - each of them receives the assignment / deassignment event and push. Always empty while the incident is closed.
Responses
Section titled “ Responses ”The updated incident
object
Unique external identifier for the incident
Type of incident
Time when the incident occurred
Time when the incident was received by the system
Time when the incident was last updated
Lifecycle state. Incidents are created OPEN; status in a create body is ignored. On an update, omit it to keep the stored value, send CLOSED to close (which stands every remaining callsign down and stamps timeClosed) or OPEN to reopen (which clears timeClosed). Any other value is a 400, and assigning resources while closed is a 409.
When the incident was closed; absent (null) while it is open. Server-owned: set when status becomes CLOSED, cleared when it goes back to OPEN, and ignored if sent in a request body.
Latitude of the incident location
Longitude of the incident location
Priority of the incident
Description of the incident
Callsigns assigned to this incident. A callsign is matched against the names of the devices the caller can reach, and one callsign may map to several devices (a vehicle often carries more than one) - each of them receives the assignment / deassignment event and push. Always empty while the incident is closed.
Example
{ "status": "OPEN"}Incident updated, but at least one callsign was not found or had a device that was not online
object
object
Unique external identifier for the incident
Type of incident
Time when the incident occurred
Time when the incident was received by the system
Time when the incident was last updated
Lifecycle state. Incidents are created OPEN; status in a create body is ignored. On an update, omit it to keep the stored value, send CLOSED to close (which stands every remaining callsign down and stamps timeClosed) or OPEN to reopen (which clears timeClosed). Any other value is a 400, and assigning resources while closed is a 409.
When the incident was closed; absent (null) while it is open. Server-owned: set when status becomes CLOSED, cleared when it goes back to OPEN, and ignored if sent in a request body.
Latitude of the incident location
Longitude of the incident location
Priority of the incident
Description of the incident
Callsigns assigned to this incident. A callsign is matched against the names of the devices the caller can reach, and one callsign may map to several devices (a vehicle often carries more than one) - each of them receives the assignment / deassignment event and push. Always empty while the incident is closed.
object
Keyed by callsign. NOT_FOUND means no device the caller can reach carries that callsign; OFFLINE means at least one of its devices was not online, and that device’s push has been queued for retry. Callsigns whose devices were all online are omitted.
object
Example
{ "incident": { "status": "OPEN" }, "details": { "deviceStatuses": { "additionalProperty": "OFFLINE" } }}Bad Request - Invalid data provided
The integration user has no permission on this incident
Incident not found
The incident is closed (or is being closed) and the body carries a non-empty resources array. Reopen it with status: OPEN first.