Skip to main content
Measures are the concrete actions your organization takes to manage risk and maintain compliance. Each measure tracks its implementation state and can be linked to risks, framework controls, tasks, and evidence.

​
The Measure object

​
id
string
required
Global ID (GID) of the measure.
​
category
string
required
Category of the measure (free-form string, e.g. "Access Control", "Encryption").
​
name
string
required
Name of the measure.
​
description
string | null
Optional description of the measure.
​
state
MeasureState
required
Current implementation state. See MeasureState enum.
​
created_at
string (date-time)
required
ISO 8601 timestamp of when the measure was created.
​
updated_at
string (date-time)
required
ISO 8601 timestamp of the last update.

​
MeasureState enum

ValueDescription
NOT_STARTEDThe measure has not yet been started
IN_PROGRESSThe measure is currently being implemented
NOT_APPLICABLEThe measure does not apply to this organization
IMPLEMENTEDThe measure is fully implemented

​
Operations

​
listMeasures

Returns all measures for the organization. MCP tool: listMeasures

​
Parameters

​
organization_id
string
required
GID of the organization.
​
size
integer
Number of results per page.
​
cursor
string
Pagination cursor from a previous response’s next_cursor.
​
order_by
object
​
filter
object

​
Response

​
measures
Measure[]
required
Array of measure objects.
​
next_cursor
string
Cursor for the next page.

​
getMeasure

Returns a single measure by ID. MCP tool: getMeasure

​
Parameters

​
id
string
required
GID of the measure.

​
Response

​
measure
Measure
required
The requested measure object.

​
addMeasure

Creates a new measure. MCP tool: addMeasure

​
Parameters

​
organization_id
string
required
GID of the organization.
​
name
string
required
Measure name.
​
category
string
required
Measure category.
​
description
string
Optional description.

​
Response

​
measure
Measure
required
The created measure object.

​
updateMeasure

Updates an existing measure. MCP tool: updateMeasure

​
Parameters

​
id
string
required
GID of the measure to update.
​
name
string
Updated name.
​
category
string
Updated category.
​
description
string | null
Updated description.
​
state
MeasureState
Updated implementation state.

​
Response

​
measure
Measure
required
The updated measure object.

​
deleteMeasure

Deletes a measure. MCP tool: deleteMeasure

​
Parameters

​
id
string
required
GID of the measure to delete.

​
Response

​
deleted_measure_id
string
required
GID of the deleted measure.

​
linkMeasure

Links a measure to another resource (a risk or a control). MCP tool: linkMeasure

​
Parameters

​
measure_id
string
required
GID of the measure.
​
resource_id
string
required
GID of the resource to link — a risk or a framework control.

​
unlinkMeasure

Removes a link between a measure and another resource. MCP tool: unlinkMeasure

​
Parameters

​
measure_id
string
required
GID of the measure.
​
resource_id
string
required
GID of the resource to unlink.
Use these tools to retrieve resources associated with a measure.

​
listMeasureRisks

Returns risks linked to a measure. MCP tool: listMeasureRisks
​
measure_id
string
required
GID of the measure.

​
listMeasureControls

Returns framework controls linked to a measure. MCP tool: listMeasureControls
​
measure_id
string
required
GID of the measure.

​
listMeasureTasks

Returns tasks linked to a measure. MCP tool: listMeasureTasks
​
measure_id
string
required
GID of the measure.

​
listMeasureEvidences

Returns evidence items collected for a measure. MCP tool: listMeasureEvidences
​
measure_id
string
required
GID of the measure.

Build docs developers (and LLMs) love

Get started for freeTalk to us