List spec versions

1 parameter

projectIdstringrequired

The project's ID, from listProjects.

3 status codes

200The spec versions.

specsarray<object>required

401The API key is missing or invalid.

errorobjectrequired

404The project or resource does not exist in this organisation.

errorobjectrequired

Error handling

A 401 is returned: The API key is missing or invalid. A 404 is returned: The project or resource does not exist in this organisation.

import { Octri } from "octri-api-sdk";

const client = new Octri({
  baseUrl: "https://api.octri.dev",
  auth: { apiKeyAuth: process.env.OCTRI_API_KEY! },
});

const result = await client.specs.list({ projectId: "9b2f1c10-7a3e-4d54-8c2a-1f6b9e0d4a21" });

{
  "specs": [
    {
      "createdAt": "2026-01-15T09:00:00Z",
      "docsPublished": true,
      "endpointCount": 42,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "isCurrent": true,
      "publishedAt": "2026-01-15T09:00:00Z",
      "source": "example_value",
      "status": "active",
      "updatedAt": "2026-01-15T09:00:00Z",
      "version": "example_value"
    }
  ]
}

Request

Response

Errors