Jump to

• Request
• Response

Get incidents for a specific location

get

/connectedWorker/clientapi/v2/projects/{projectId}/locations/{locationId}/incidents

This operation retrieves the incidents for a given location.

Request

Path Parameters

• locationId: integer(int64)
  Location identifier
• projectId: integer(int64)
  Project identifier

Back to Top

Response

Supported Media Types

• application/json

200 Response

Incidents were successfully retrieved

Body ()

Root Schema : Incidents

Type: object

Show Source

• items: array items
• links(optional): array links

{
    "type":"object",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Incident"
            }
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object Incident

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Incident"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : Incident

Type: object

Show Source

• altitude(optional): number
  Altitude of occurrence of the incident. Used only for incident creation.

  Example: 12.12345
• createdTime(optional): string(date-time)
  Read Only: true

  Time when the incident was created in ISO-8601 format.

  Example: 2018-01-01T11:59:59
• description: string
  Description of the incident. Can be updated. Cannot be blank.

  Example: Description of an incident
• employeeId: string
  Id of the employee for whom the incident was created. Used only for incident creation.

  Example: johnSmith
• id(optional): integer(int64)
  Read Only: true

  The unique id of the object

  Example: 53
• lastModifiedTime(optional): string(date-time)
  Read Only: true

  Time when the incident was modified for the last time in ISO-8601 format.

  Example: 2018-01-01T11:59:59
• latitude: number
  Minimum Value: -90

  Maximum Value: 90

  Latitude of occurrence of the incident. Used only for incident creation.

  Example: 39.215302
• links(optional): array links
• longitude: number
  Minimum Value: -180

  Maximum Value: 180

  Longitude of occurrence of the incident. Used only for incident creation

  Example: 26.308674
• priority: string
  Allowed Values: [ "HIGH", "MEDIUM", "LOW" ]

  Priority of the incident.

  Example: HIGH
• source(optional): string
  Read Only: true

  Allowed Values: [ "RULE", "MANUALLY_CREATED" ]

  Source of the incident.

  Example: RULE
• state(optional): string
  Allowed Values: [ "NEW", "OPEN", "WORK_IN_PROGRESS", "RESOLVED", "WITHDRAWN" ]

  State of the incident. Automatically assigned to 'NEW' on backend during creation of the incident. Can be updated.

  Example: NEW
• summary: string
  Minimum Length: 0

  Maximum Length: 255

  Summary of the incident. Can be updated. Cannot be blank. Max length is 255 characters.

  Example: This is a summary of an incident
• tags(optional): array tags
  Unique Items Required: true

  Tags for this incident. Can be updated.
• type: string
  Allowed Values: [ "HAZARD", "SAFETY_VIOLATION", "ACCIDENT" ]

  Type of the incident.

  Example: HAZARD

{
    "type":"object",
    "required":[
        "description",
        "employeeId",
        "latitude",
        "longitude",
        "priority",
        "summary",
        "type"
    ],
    "properties":{
        "id":{
            "type":"integer",
            "format":"int64",
            "example":53,
            "description":"The unique id of the object",
            "readOnly":true
        },
        "type":{
            "type":"string",
            "example":"HAZARD",
            "description":"Type of the incident.",
            "enum":[
                "HAZARD",
                "SAFETY_VIOLATION",
                "ACCIDENT"
            ]
        },
        "source":{
            "type":"string",
            "example":"RULE",
            "description":"Source of the incident.",
            "readOnly":true,
            "enum":[
                "RULE",
                "MANUALLY_CREATED"
            ]
        },
        "priority":{
            "type":"string",
            "example":"HIGH",
            "description":"Priority of the incident.",
            "enum":[
                "HIGH",
                "MEDIUM",
                "LOW"
            ]
        },
        "state":{
            "type":"string",
            "example":"NEW",
            "description":"State of the incident. Automatically assigned to 'NEW' on backend during creation of the incident. Can be updated.",
            "enum":[
                "NEW",
                "OPEN",
                "WORK_IN_PROGRESS",
                "RESOLVED",
                "WITHDRAWN"
            ]
        },
        "description":{
            "type":"string",
            "example":"Description of an incident",
            "description":"Description of the incident. Can be updated. Cannot be blank."
        },
        "summary":{
            "type":"string",
            "example":"This is a summary of an incident",
            "description":"Summary of the incident. Can be updated. Cannot be blank. Max length is 255 characters.",
            "minLength":0,
            "maxLength":255
        },
        "createdTime":{
            "type":"string",
            "format":"date-time",
            "example":"2018-01-01T11:59:59",
            "description":"Time when the incident was created in ISO-8601 format.",
            "readOnly":true
        },
        "lastModifiedTime":{
            "type":"string",
            "format":"date-time",
            "example":"2018-01-01T11:59:59",
            "description":"Time when the incident was modified for the last time in ISO-8601 format.",
            "readOnly":true
        },
        "tags":{
            "type":"array",
            "example":"[\"tag1\", \"tag2\"]",
            "description":"Tags for this incident. Can be updated.",
            "uniqueItems":true,
            "items":{
                "type":"string"
            }
        },
        "employeeId":{
            "type":"string",
            "example":"johnSmith",
            "description":"Id of the employee for whom the incident was created. Used only for incident creation."
        },
        "latitude":{
            "type":"number",
            "example":39.215302,
            "description":"Latitude of occurrence of the incident. Used only for incident creation.",
            "minimum":-90,
            "maximum":90
        },
        "longitude":{
            "type":"number",
            "example":26.308674,
            "description":"Longitude of occurrence of the incident. Used only for incident creation",
            "minimum":-180,
            "maximum":180
        },
        "altitude":{
            "type":"number",
            "example":12.12345,
            "description":"Altitude of occurrence of the incident. Used only for incident creation."
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : tags

Type: array

Unique Items Required: true

Tags for this incident. Can be updated.

Show Source

• Array of: string

{
    "type":"array",
    "example":"[\"tag1\", \"tag2\"]",
    "description":"Tags for this incident. Can be updated.",
    "uniqueItems":true,
    "items":{
        "type":"string"
    }
}

Example:

["tag1", "tag2"]

Nested Schema : Link

Type: object

Show Source

• href: string
  The target resource's URI
• rel: string
  Relation type

{
    "type":"object",
    "required":[
        "href",
        "rel"
    ],
    "properties":{
        "rel":{
            "type":"string",
            "description":"Relation type"
        },
        "href":{
            "type":"string",
            "description":"The target resource's URI"
        }
    }
}

Back to Top