Failures

Create a Failure

This endpoint allows you to create a Failure.

  • problem_id: refers to the type of problem. First, you need to retrieve the problem areas (GET /problems). Then, list the sub-problems from the desired area (GET /problems/{problem_id}/subproblems) and, from the response, use the respective problem_id.
  • local_id: refers to the location (GET /locations) related to the Failure. It can't be of type "building" neither "location-folder", this is, only of type "location".
post/failures

Request

  • Base URL: https://api.infraspeak.com/v3
  • URL: https://api.infraspeak.com/v3/failures
  • Auth: HTTP bearer

Request body

problem_idinteger required

ID of the associated problem. Refers to the type of Problem and need to be a Problem Type, not a Problem Area. To get the Problem Types, first, you need to retrieve the Problem Areas (GET /problems). Then, list the Problem Types from the desired area (GET /problems/{problem_id}/subproblems) and, from the response, use the respective problem_id.

descriptionstring

A more detailed description of the reported incident.

observationsstring

A longer description or anything with longer text that needs to be reported.

priority1 | 2 | 3 | 4 required

Failure priority number, being 1 the lowest priority and 4 the highest priority.

client_idinteger required

ID of the client associated to the Failure

local_idinteger required

ID of the location associated to the Failure

operator_idinteger

ID of the operator that owns the Failure. By default, uses the ID of the Operator associated to the API token.

report_type'contact' | 'operator'

Type of the Failure's reporter. The failure can be reported by an Operator or by a Contact.

report_idinteger

ID of the operator or contact who reported the Failure

supplier_idinteger

ID of the supplier associated to the Failure

gatekeeper_idinteger

ID for the associated Gatekeeper

cost_center_idinteger

ID of the associated CostCenter

include_automatic_assigneesboolean

If is to append automatic assignees when a user select a custom list of assignees

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.