Issues

Create Issue (legacy)

post/tasks/v1/incidents

Request

  • Base URL
    https://api.mitti.com
  • Auth
    HTTP bearer

Request body

task_idstring

A UUID to identify the issue. Optional. If it is not provided, it will be automatically generated.

titlestring required

Required. Title of the issue (maximum 255 characters).

descriptionstring

Optional. Description of the issue (maximum 500 characters).

created_atstring date-time

Optional. The date and time this issue was created. If no date is provided, the current time will be used. Must be sent in the Internet Date-Time format, more information about the type is available here: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#timestamp.

category_idstring required

Required. The ID of the issue's category. Categories are configured at an organization level, and can be retrieved from the GetCategories endpoint. The issue will not be created if the category is missing, and an error will be returned.

status_idstring

Optional. ID of the issue's status. If not set, this issue will be stored with the default status (Open). An issue can be open, in progress, or resolved, and these are represented by hardcoded UUID values. Open status: 547ed646-5e34-4732-bb54-a199d304368a. In Progress status: ca6f3bc7-b943-406e-8399-8a713b7e6268. Resolved status: 450484b1-56cd-4784-9b49-a3cf97d0c0ad.

site_idstring

The ID of the site associated with the issue. Site IDs can be retrieved on platform.

occurred_atstring date-time

Optional. Date and time this incident occurred at

asset_idstring

Optional. The ID of the asset associated with this issue.

ai_generatedboolean

The Assistant passes the mitti-ai-marked header on the create call, so a new caller sets it the same way. The field stays for existing callers.

Response

A successful response.

incident_idstring

Changes

No recorded changes to this operation across all 2 revisions of this API.