Version Endpoints

List Versions

GET /v1/packages/:packageId/versions

List all versions of a package.

Response:

{
  "data": [
    {
      "id": "ver_abc123",
      "package_id": "pkg_xyz789",
      "version": "1.0.0",
      "changelog": "Initial release",
      "status": "published",
      "published_at": "2025-01-09T10:30:00Z",
      "created_at": "2025-01-09T10:30:00Z"
    }
  ]
}

Create Version

POST /v1/packages/:packageId/versions

Create a new version.

Request Body:

{
  "version": "1.0.0",
  "changelog": "Initial release",
  "status": "draft"
}

Get Version

GET /v1/versions/:versionId

Get a specific version by ID.

Deprecate Version

POST /v1/versions/:versionId/deprecate

Mark a version as deprecated.

Request Body:

{
  "message": "This version has a critical bug. Please upgrade to 1.0.1"
}

Delete Version

DELETE /v1/versions/:versionId

Delete a version (soft delete).

Response: 204 No Content