The saved versions of the traceability matrix

GET

/v1/matrix-versions

const url = 'https://beta-api.plune.ai/v1/matrix-versions';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://beta-api.plune.ai/v1/matrix-versions \
  --header 'Authorization: Bearer <token>'

A version is a SNAPSHOT (#1269): the requirements of the project with their cases and coverage over a period, frozen when somebody saved it. Newest first, without the content (GET /v1/matrix-versions/{id} has it). Any member reads, a reader too.

Authorizations

bearerAuth
cookieAuth

Responses

200

The versions

application/json

object

versions

required

Array<object>

object

required

Stable: it names this snapshot for good, so a link can point at it (#1266).

string format: uuid

number

required

V1, v2, … within the project; a number is never reused.

integer

>= 1

periodFrom

required

The start of the period the coverage was counted over.

string format: date-time

periodTo

required

The end of the period, included.

string format: date-time

builtAt

required

When the snapshot was saved.

string format: date-time

authorName

required

Whoever saved it: their name, or their address when they have none; as it was then.

string

Example

{
  "versions": [
    {
      "id": "6f1c2b3a-0000-4000-8000-0000000000b3",
      "number": 3,
      "periodFrom": "2026-09-16T00:00:00.000Z",
      "periodTo": "2026-10-15T23:59:59.999Z",
      "builtAt": "2026-09-16T09:12:04.151Z",
      "authorName": "Dana"
    }
  ]
}

401

No / invalid token or session