Create Issue

post

https://api.mitti.com/tasks/v1/incidents/submit

Body Params

task_id

string

Optional. The unique identifier of the incident
If not provided, UUID will be generated server side

title

string

required

Required. Title of the incident
Title is limited to only 255 characters max

created_at

date-time

Optional. Date and time this incident was created

category_id

string

required

Required. ID of the incident's category
If not set, this incident will be stored with the default category(None)

answered_questions

array of strings

Optional. An array of all, if any, custom questions that have been answered
by the contributor
@deprecated: Use QuestionAnswer instead. This was a field used for string
custom questions. We've since moved to structured custom questions in the
QuestionAnswer field.

answered_questions

string

Optional. The email address of the contributor

media

array of objects

Optional. Array of media items to be linked to the incident.

media

site_id

string

Optional. ID of the site to associate with the incident.
If not provided, no site will be associated with the incident.

name

string

Optional. The name of the contributor

contact

string

Optional. The contact details of the contributor

location

object

The location that the incident occurred at

access_token

string

Optional. The access token used to authenticate the request. This field
should be set when following the contributor flow. Otherwise, authenticate
via normal means.

description

string

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

questions_and_answers

array of objects

Optional. An array of all, if any, custom questions that have been answered
for this issue.

questions_and_answers

items

array of objects

Optional. The category fields and questions that applied to this incident
when it was created.

items

occurred_at

date-time

Optional. Date and time this incident occurred at

asset_id

string

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

ai_generated

boolean

Use ai_marking. True when this issue was created via an AI-assisted
flow, for example the QR-code AI Issue Creation flow seeded by
GenerateIncidentStream.

ai_marking

object

Optional. The AI marking the caller declares for this issue, under the
write rules. A caller can set a flag true and cannot clear it, and false is
recorded as absent. Surfaces on Incident.ai_marking. The Assistant sets it
through the mitti-ai-marked header rather than this field.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A successful response.

defaultAn unexpected error response.