Sign in

v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB
Issues

Create Issue

Use this API to create an issue.

post/v1/issues

Request body

namestring required

The name that describes the issue.

orgGroupIdstring uuid required

The unique identifier of the organization associated with the issue.

priority'Low' | 'Medium' | 'High' | 'Critical' required

The priority level of the issue.

descriptionstring

The description of the issue.

deadlinestring date

The date by which the issue should be resolved.

ownerIdsstring[]

The unique identifiers of the issue owners who will remediate the issue.

approverIdsstring[]

The unique identifier(s) of the users assigned as approvers of the issue.

reasonForClosurestring

The reason why the issue was closed.

categorystring

The category of the issue.

sourceType'Control' | 'Evidence' | 'Initiative' | 'Issue' | 'Risk' | 'assessment' | 'assets' | 'entities' | 'policies' | 'procedures' | 'processing-activities' | 'standards' | 'vendors'

The entity type of the source record.

sourceIdstring uuid

The unique identifier of the source record.

notestring

The notes related to resolving the issue.

actionPlanstring

The remediation plan for the issue.

attributesobject

The details of the associated attributes.

Example request

{
  "name": "Expired Policies",
  "orgGroupId": "cb49a431-3d3d-4352-9daf-71f6ea2b3d89",
  "priority": "High",
  "description": "System would be at risk if we do not renew access policies",
  "deadline": "2021-12-31",
  "reasonForClosure": "Resolved",
  "category": "General",
  "sourceType": "Risk",
  "sourceId": "ad49a0f1-3d3d-4352-9daf-71f6ea2b2c86",
  "note": "Closed the issue as its been resolved",
  "actionPlan": "1. Disabled user's unauthorized access.\n 2. Informed relevant teams.",
  "attributes": {
    "textAttributeName": [
      {
        "value": "Text"
      }
    ],
    "optionBasedAttributeName": [
      {
        "id": "f2229953-b4b5-4042-8cb9-b78038cc4c46"
      }
    ],
    "priorityLevel": [
      {
        "id": "f27598c0-c5b9-466d-8a2e-9afdf61e6fe3",
        "value": "High",
        "valueKey": "IM.Issue.Attribute.PriorityLevel.Option.High",
        "colorCode": "#cd491d",
        "optionSelectionValue": "20",
        "displayLabel": null,
        "disabled": false
      }
    ]
  }
}

Response

Issue created successfully

idstring uuid

The unique identifier of the issue.

numberinteger

The page number of the results.

namestring

The name that describes the issue.

orgGroupIdstring uuid

The unique identifier of the organization associated with the issue.

descriptionstring

The description of the issue.

deadlinestring date

The date by which the issue should be resolved.

ownerIdsstring[]

The unique identifiers of the issue owners who will remediate the issue.

approverIdsstring[]

The unique identifier(s) of the users assigned as approvers of the issue.

reasonForClosurestring

The reason why the issue was closed.

categorystring

The category of the issue.

status'Open' | 'Closed'

The status of the issue.

sourceType'Control' | 'Evidence' | 'Initiative' | 'Issue' | 'Risk' | 'assessment' | 'assets' | 'entities' | 'policies' | 'procedures' | 'processing-activities' | 'standards' | 'vendors'

The entity type of the source record.

sourceIdstring uuid

The unique identifier of the source record.

notestring

The notes related to resolving the issue.

actionPlanstring

The remediation plan for the issue.

closedBystring uuid

The unique identifier of the user who closed the issue.

closedDatestring

The date when the issue is closed.

createdBystring uuid

The unique identifier of the user who created the issue.

createdDatestring date

The date when the issue is created.

attributesobject

The details of the associated attributes.

Example response

{
  "id": "ab129a431-3d3d-4352-9daf-71f6ea2b3d70",
  "number": 1,
  "name": "Expired Policies",
  "orgGroupId": "cb49a431-3d3d-4352-9daf-71f6ea2b3d89",
  "description": "System would be at risk if we do not renew access policies",
  "deadline": "2021-12-31",
  "reasonForClosure": "Resolved",
  "category": "General",
  "status": "Open",
  "sourceType": "Risk",
  "sourceId": "ad49a0f1-3d3d-4352-9daf-71f6ea2b2c86",
  "note": "Closed the issue as its been resolved",
  "actionPlan": "1. Disabled user's unauthorized access.\n 2. Informed relevant teams.",
  "closedBy": "ad49a0f1-3d3d-4352-9daf-71f6ea2b2c86",
  "closedDate": "2025-05-07T14:42:32.950Z",
  "createdBy": "ad49a0f1-3d3d-4352-9daf-71f6ea2b2c86",
  "createdDate": "2021-12-31",
  "workflowAndStage": {
    "id": "b271c01a-89a9-41b1-8185-0a3e2bfdad84",
    "name": "Vendor On-Boarding Workflow",
    "type": "Vendor",
    "workflowMode": "BASIC",
    "stageId": "9fc111cb-c379-4f08-8aff-5be954c1a6e6",
    "stageName": "Start On-Boarding"
  },
  "auditFields": {
    "createdBy": {
      "id": "c21319953-b4b5-4042-8cb9-b78038cc4c51",
      "name": "Name"
    },
    "lastModifiedBy": {
      "id": "c21319953-b4b5-4042-8cb9-b78038cc4c51",
      "name": "Name"
    }
  },
  "attributes": {
    "textAttributeName": [
      {
        "value": "Text"
      }
    ],
    "optionBasedAttributeName": [
      {
        "id": "f2229953-b4b5-4042-8cb9-b78038cc4c46"
      }
    ]
  }
}