---
title: "Create a row in an ISMS register"
method: POST
path: "/v1/isms/documents/{id}/registers/{register}"
tags: ["ISMS"]
---

# Create a row in an ISMS register

`POST /v1/isms/documents/{id}/registers/{register}`

Create a row in an ISMS register in Comp AI.

## Path parameters

- `id` string, required
- `register` string, required

## Request body

- object
  - `kind` 'internal' | 'external'
  - `category` string
  - `description` string
  - `effect` string
  - `name` string
  - `needsExpectations` string
  - `interestedPartyId` string
  - `partyName` string
  - `requirement` string
  - `treatment` string
  - `objective` string
  - `target` string
  - `ownerMemberId` string
  - `cadence` string
  - `plan` string
  - `measurementMethod` string
  - `status` 'not_started' | 'on_track' | 'at_risk' | 'met' | 'planned' | 'in_progress' | 'complete' | 'open' | 'closed'
  - `responsibilities` string
  - `authorities` string
  - `authorityGrantedBy` string
  - `requiredCompetence` string
  - `auditRoute` 'in_house' | 'external' | 'training_planned', nullable
  - `auditRouteMemberId` string, nullable
  - `auditFirmName` string, nullable
  - `auditEvidenceRef` string, nullable
  - `auditCourse` string, nullable
  - `auditDueDate` string, nullable
  - `roleId` string
  - `memberId` string
  - `basisOfCompetence` 'education' | 'training' | 'experience' | 'combination', nullable
  - `evidenceRetained` string, nullable
  - `gap` string, nullable
  - `remediationAction` string, nullable
  - `remediationDueDate` string, nullable
  - `whatIsMeasured` string
  - `method` string
  - `monitorMemberId` string, nullable
  - `analyzeMemberId` string, nullable
  - `objectiveId` string, nullable
  - `isActive` boolean
  - `metricId` string
  - `periodStart` string — First day of the covered period (YYYY-MM-DD), aligned to the metric cadence
  - `value` string
  - `note` string, nullable
  - `scope` string
  - `criteria` string
  - `auditorName` string, nullable
  - `plannedStartDate` string, nullable
  - `plannedEndDate` string, nullable
  - `conclusionVerdict` 'conform' | 'substantially_conform' | 'not_yet_conform', nullable
  - `conclusionNotes` string, nullable
  - `signoffAuditorName` string, nullable
  - `signoffAuditorDate` string, nullable
  - `signoffSpoName` string, nullable
  - `signoffSpoDate` string, nullable
  - `signoffTopMgmtName` string, nullable
  - `signoffTopMgmtDate` string, nullable
  - `auditId` string
  - `controlRef` string
  - `whatWasTested` string
  - `whereToFind` string
  - `result` 'conformity_confirmed' | 'nonconformity_raised' | 'observation_raised' | 'not_sampled', nullable
  - `notes` string, nullable
  - `type` 'nc_major' | 'nc_minor' | 'ofi' | 'observation'
  - `controlId` string, nullable
  - `clauseOrControl` string, nullable
  - `dueDate` string, nullable
  - `closureEvidence` string, nullable
  - `position` integer

## Response `200`

Register row created

---

[API](https://skmtc.net/trycompai/apis/comp-ai-api.md) · [All operations](https://skmtc.net/trycompai/apis/comp-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycompai/comp-ai-api/revisions/726b9523fb22/schema)