COcortex
Verifications

Create a verification period

Changed on

Opens a verification campaign over the entities its scope selects. Every selected entity gets a PENDING verification immediately, except under a cqlQuery scope, which is evaluated in the background, so the counts read zero until it finishes.

post/api/v1/verification-periods

Request

  • Base URL
    https://api.getcortexapp.com
  • URL
    https://api.getcortexapp.com/api/v1/verification-periods
  • Auth
    HTTP bearer

Request body

descriptionstring

What owners are being asked to confirm

endDatestring date-time required

The day the period closes, inclusive

namestring required

Display name

reasonRequiredboolean

Whether a reason is required to mark an entity incorrect. Marking an entity correct never requires one. Defaults to false.

requiredCustomRoleTagsstring[] required

Tags of custom Cortex roles a user must hold to verify

requiredRolesstring[] required

Cortex roles a user must hold to verify. Empty means any owner of the entity may verify.

requiredTeamRoleTagsstring[] required

Tags of team roles a user must hold on a team that owns the entity in order to verify

startDatestring date-time required

The day the period opens, inclusive

Example request

{
  "name": "Q3 Ownership Review",
  "requiredRoles": [
    "OWNER"
  ],
  "scope": {
    "cqlQuery": "tag != null",
    "types": [
      "service"
    ]
  }
}

Response

The created verification period

cidstring required

Stable identifier, usable wherever a period CID is accepted

descriptionstring

What owners are being asked to confirm

endDatestring date-time required

When the period closes

isActiveboolean required

Whether the period is open today, and so still accepting verifications

namestring required

Display name

reasonRequiredboolean required

Whether a reason is required when an entity is marked incorrect

requiredCustomRoleTagsstring[] required

Tags of custom Cortex roles a user must hold to verify

requiredRolesstring[] required

Cortex roles a user must hold to verify

requiredTeamRoleTagsstring[] required

Tags of team roles a user must hold on an owning team to verify

startDatestring date-time required

When the period opens

Example response

{
  "cid": "vp0a1b2c3d4e5f6789",
  "counts": {
    "pending": 12,
    "verifiedCorrect": 40,
    "verifiedIncorrect": 3
  },
  "isActive": true,
  "name": "Q3 Ownership Review",
  "requiredRoles": [
    "OWNER"
  ],
  "scope": {
    "cqlQuery": "tag != null",
    "types": [
      "service"
    ]
  }
}

Changes