Tools: Audits

listAudits

🔍 Read-only

List all audits for the organization.

Parameters: {
  "organization_id": "org_xxx",
  "size": 50,
  "cursor": "optional_cursor",
  "filter": { "status": "ACTIVE" }
}

Supports: Pagination, filtering by status Returns: Array of audits, next_cursor for pagination

Example:
AI: "List all active audits"
    [Uses listAudits tool with status filter]
AI: "Show completed audits"
    [Uses listAudits tool with status=COMPLETED filter]

getAudit

🔍 Read-only

Get audit details.

Parameters: {
  "organization_id": "org_xxx",
  "audit_id": "audit_xxx"
}

Returns: Full audit details including findings and scope

Example:
AI: "Get details for audit audit_abc123"
    [Uses getAudit tool]

addAudit

✏️ Write

Add a new audit.

Parameters: {
  "organization_id": "org_xxx",
  "title": "Audit Title",
  "audit_type": "INTERNAL",
  "scheduled_date": "2025-03-01"
}

Returns: Created audit object

Example:
AI: "Add an internal audit scheduled for March 1"
    [Uses addAudit tool]

updateAudit

✏️ Write

Update audit status and details.

Parameters: {
  "organization_id": "org_xxx",
  "audit_id": "audit_xxx",
  "status": "COMPLETED",
  "completion_date": "2025-03-15",
  "visible": true
}

Returns: Updated audit object

Example:
AI: "Mark audit audit_abc123 as COMPLETED"
    [Uses updateAudit tool]