---
title: "Marking an Event as Open"
method: POST
path: "/cad/events/{externalId}/open"
tags: ["CAD Events"]
---

# Marking an Event as Open

`POST /cad/events/{externalId}/open`

Opens event with given externalId (removes closedAt time).

## Path parameters

- `externalId` string, uuid, required

## Response `200`

Success

- Event
  - `externalId` string, required — external id of event used for identification
  - `groupingId` string — optional id used to link multiple events together
  - `displayId` string — optional override of external id to be displayed in UI
  - `eventType` string, required
  - `priority` integer, required — 1-indexed value representing priority of the event (lower is higher priority)
  - `displayPriority` string — optional override of priority value to be displayed in UI
  - `timestamp` string, date-time — RFC3339 UTC datetime string of when event started (defaults to current time if not provided)
  - `closedAt` string, date-time — RFC3339 UTC datetime string of when event ended (event considered open if not set)
  - `displayStatus` string — optional custom status of event to be displayed in UI
  - `department` string — optional field for specifying department involved (fire, EMS, etc.)
  - `area` string — optional field for specifying district/sector/beat involved in event
  - `narratives` string[]
  - `location` Location — either latitude and longitude is required, or one of streetAddress/city/state
    - `name` string — commmon name to identify location by
    - `latitude` number
    - `longitude` number
    - `streetAddress` string
    - `city` string
    - `state` string
    - `country` string
    - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
      - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
      - `value` object — value of the metadata. Must be a string, number, or boolean
  - `callerInfo` CallerInfo
    - `name` string
    - `phoneNumber` string
    - `timestamp` string, date-time — RFC3339 UTC datetime string
    - `location` Location — either latitude and longitude is required, or one of streetAddress/city/state
      - `name` string — commmon name to identify location by
      - `latitude` number
      - `longitude` number
      - `streetAddress` string
      - `city` string
      - `state` string
      - `country` string
      - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
        - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
        - `value` object — value of the metadata. Must be a string, number, or boolean
    - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
      - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
      - `value` object — value of the metadata. Must be a string, number, or boolean
  - `dispatchedUnits` DispatchedUnit[]
    - `id` string, required
    - `displayId` string — optional override of unit id to be displayed in UI
    - `dispatchTime` string, date-time, required — RFC3339 UTC datetime string
    - `arrivalTime` string, date-time — RFC3339 UTC datetime string
    - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
      - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
      - `value` object — value of the metadata. Must be a string, number, or boolean
  - `involvedVehicles` InvolvedVehicle[]
    - `color` string
    - `make` string
    - `model` string
    - `year` integer
    - `plateNumber` string
    - `plateState` string
    - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
      - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
      - `value` object — value of the metadata. Must be a string, number, or boolean
  - `involvedPersons` InvolvedPerson[]
    - `name` string
    - `externalId` string — unique identifier for person, generated if not provided
    - `description` string
    - `dateOfBirth` string, date
    - `email` string
    - `secondaryEmail` string
    - `phone` string
    - `secondaryPhone` string
    - `streetAddress` string
    - `secondaryStreetAddress` string
    - `ethnicity` string
    - `eyeColor` string
    - `hairColor` string
    - `height` string
    - `age` integer
    - `gender` string
    - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
      - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
      - `value` object — value of the metadata. Must be a string, number, or boolean
  - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
    - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
    - `value` object — value of the metadata. Must be a string, number, or boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Event Not Found (provided externalId doesn't match any existing)

---

[API](https://skmtc.net/flocksafety/apis/oauth-api.md) · [All operations](https://skmtc.net/flocksafety/apis/oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flocksafety/oauth-api/revisions/126df7964ba5/schema)