StagePackageList

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/npm/json-schema/npm-stage-package-list-schema.json",
  "title": "StagePackageList",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/npm-registry-reference-openapi.yml#/components/schemas/StagePackageList",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/StagePackageVersion"
      },
      "description": "List of staged package versions for the authenticated user."
    },
    "page": {
      "type": "integer",
      "description": "The current page number (0-indexed)."
    },
    "perPage": {
      "type": "integer",
      "description": "The number of items returned per page."
    },
    "total": {
      "type": "integer",
      "description": "The total number of staged package versions available."
    }
  },
  "$defs": {
    "StagePackageVersion": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "Unique identifier for the staged package version."
        },
        "packageName": {
          "type": "string",
          "description": "The name of the package."
        },
        "version": {
          "type": "string",
          "description": "The version of the package that is being staged."
        },
        "tag": {
          "type": "string",
          "description": "The dist-tag associated with the staged package version."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp when the item was staged."
        },
        "actor": {
          "type": "string",
          "description": "The username of the user who staged the package version."
        },
        "actorType": {
          "type": "string",
          "description": "The type of the actor (e.g., user, trusted automation)."
        },
        "access": {
          "type": "string",
          "description": "The access level for the staged package version. 'public' or 'private'.\n",
          "enum": [
            "public",
            "private"
          ]
        },
        "shasum": {
          "type": "string",
          "description": "The shasum of the package tarball."
        },
        "status": {
          "type": "string",
          "description": "The staged package lifecycle status. `validating` means automated review is still processing; `staged` means the version is ready for maintainer review and approval.\n",
          "enum": [
            "validating",
            "staged"
          ]
        }
      }
    }
  }
}