v1

latestOpenAPI 3.1.02026-07-263911,4691.1 MB
Issues

Create Issue (legacy)

post/tasks/v1/incidents

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

Optional. True when this issue is being created via an AI-assisted flow. The client declares AI involvement; the server persists the flag and surfaces it on Incident.ai_generated. Top-level marker for EU AI Act Article 50(2) machine-readable detectability (AI-522).

Response

A successful response.

incident_idstring