v1

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

Create Audit

Use this API to create a new audit.

post/api/audit-management/v1/audits

Request body

auditSourceType'NONE' | 'VENDOR' | 'ASSET' | 'PROCESING_ACTIVITY' required

Audit source type

attributesobject

Custom Attributes

Example request

{
  "header": {
    "name": "Annual Security Compliance Audit",
    "auditTypeId": "123e4567-e89b-12d3-a456-426614174002",
    "goal": "To assess compliance with information security controls and identify areas for improvement",
    "startDate": "2025-06-01",
    "endDate": "2025-06-30"
  },
  "auditSourceType": "NONE",
  "orgGroup": {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "name": "Finance Department"
  },
  "framework": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "ISO 27001"
  },
  "auditors": [
    {
      "email": "john.auditor@example.com"
    }
  ],
  "approvers": [
    {
      "email": "john.auditor@example.com"
    }
  ],
  "scopes": [
    {
      "controlId": "123e4567-e89b-12d3-a456-426614174000",
      "auditorEmail": "auditor@example.com",
      "approverEmail": "approver@example.com"
    }
  ],
  "attributes": {
    "priority": [
      {
        "value": "High"
      }
    ]
  }
}

Response

Created

string uuid required