Skip to main content

V1AssessmentAreaToImprove

idstring

Unique identifier of the area to improve

Example: RI0DCKDYR0
updatedDatestring<date-time>nullable

Last update date

Example: 2025-10-21T15:30:56.214000+00:00
titlestring

Title of the area to improve

Example: The general condition of the dormitories need improvement.
categorystringnullable

Category of the area to improve

Example: Drinking Water
subCategorystringnullable

Sub-category of the area to improve

Example: Social
descriptionstringnullable

Detailed description

Example: The facility needs better ventilation
requiredCorrectionboolean

Whether correction is required

Example: false
recommendationstringnullable

Recommendation for improvement

Example: Install new equipment
statusstring

Status of the area to improve

Example: new
rootCausesstring[]

List of root causes

resolutionsstring[]

List of resolutions

personInChargestringnullable

Person responsible for the improvement

Example: John Doe
completionDatestring<date>nullable

Target completion date

Example: 2025-12-31
resolvedDatestring<date-time>nullable

Date when the issue was resolved

Example: 2025-12-15T10:36:56.057000+00:00
referenceIdstringnullable

Reference identifier

Example: tutest-issue-4-2
linkedFindingsobject[]

List of linked findings

customFieldsobjectnullable

Custom fields data

commentsobject[]

List of comments

uploadedFilesobject[]

List of uploaded files

areaToImproveLabelsobject[]

Labels associated with this area to improve

fields object[]

Custom fields with questions and answers

  • Array [
  • improvementAreaIdstring

    ID of the improvement area

    Example: 07e1d9ef-aebe-4901-b26c-941cb5983832
    fieldIdstring

    ID of the field

    Example: b62ca36f-fa86-4ee0-ae96-bad52c2c46b2
    field object

    Field definition

    idstring

    Field ID

    Example: b62ca36f-fa86-4ee0-ae96-bad52c2c46b2
    fieldNamestring

    Name of the field

    Example: Root Causes
    descriptionstring

    Field description

    Example: Describe the root causes
    enabledboolean

    Whether the field is enabled

    Example: true
    responseTypestring

    Type of response expected

    Example: MULTIPLE_TEXT_ENTRIES
    requirementstring

    Field requirement level

    Example: REQUIRED_WHEN_ATI_MANDATORY
    systemKeystringnullable

    System key for the field

    Example: ROOT_CAUSES
    settingsobjectnullable

    Additional settings

    orderinteger

    Display order

    Example: 0
    choicesobject[]

    Available choices for the field

    createdAtstring<date-time>

    Creation timestamp

    Example: 2025-11-03T14:40:34.815Z
    updatedAtstring<date-time>

    Last update timestamp

    Example: 2025-11-03T14:40:34.815Z
    answer object

    Answer to the field

    valuestringnullable

    Answer value

    Example: Some text answer
    choicesstring[]

    Selected choices

    textAreasstring[]

    Text area responses

    attachmentsobject[]

    Attached files

  • ]
  • V1AssessmentAreaToImprove
    {
    "id": "RI0DCKDYR0",
    "updatedDate": "2025-10-21T15:30:56.214000+00:00",
    "title": "The general condition of the dormitories need improvement.",
    "category": "Drinking Water",
    "subCategory": "Social",
    "description": "The facility needs better ventilation",
    "requiredCorrection": false,
    "recommendation": "Install new equipment",
    "status": "new",
    "rootCauses": [
    "string"
    ],
    "resolutions": [
    "string"
    ],
    "personInCharge": "John Doe",
    "completionDate": "2025-12-31",
    "resolvedDate": "2025-12-15T10:36:56.057000+00:00",
    "referenceId": "tutest-issue-4-2",
    "linkedFindings": [
    {}
    ],
    "customFields": {},
    "comments": [
    {}
    ],
    "uploadedFiles": [
    {}
    ],
    "areaToImproveLabels": [
    {}
    ],
    "fields": [
    {
    "improvementAreaId": "07e1d9ef-aebe-4901-b26c-941cb5983832",
    "fieldId": "b62ca36f-fa86-4ee0-ae96-bad52c2c46b2",
    "field": {
    "id": "b62ca36f-fa86-4ee0-ae96-bad52c2c46b2",
    "fieldName": "Root Causes",
    "description": "Describe the root causes",
    "enabled": true,
    "responseType": "MULTIPLE_TEXT_ENTRIES",
    "requirement": "REQUIRED_WHEN_ATI_MANDATORY",
    "systemKey": "ROOT_CAUSES",
    "settings": {},
    "order": 0,
    "choices": [
    {}
    ],
    "createdAt": "2025-11-03T14:40:34.815Z",
    "updatedAt": "2025-11-03T14:40:34.815Z"
    },
    "answer": {
    "value": "Some text answer",
    "choices": [
    "string"
    ],
    "textAreas": [
    "string"
    ],
    "attachments": [
    {}
    ]
    }
    }
    ]
    }