The plugin version object

⚠️

Preview — this feature is being built; the design below is the spec.

The plugin_version object as the API returns it. Every field below appears in every response that returns this object; fields with no value are null rather than missing.

Example

{
  "plugin_id": "plg_01JCN1P3R5T7V9X1Z3B5",
  "version": "1.4.0",
  "type": "plugin_version",
  "sha256": "a81c…44e0",
  "bytes": 48211,
  "scan": {
    "status": "passed",
    "findings": []
  },
  "manifest": {
    "commands": [
      "review"
    ],
    "hooks": [
      "pre_edit"
    ],
    "mcp_servers": []
  },
  "created_at": "2026-11-02T10:00:00Z"
}

Fields

Field	Type	Description
`plugin_id`	string	See the endpoint pages below.
`version`	string	From the manifest; must be higher than every earlier version.
`type`	string	The object type, always `plugin_version`.
`sha256`	string	See the endpoint pages below.
`bytes`	integer	See the endpoint pages below.
`scan`	object	`status` is `pending`, `passed` or `failed`. Failed versions cannot be served.
`manifest`	object	The commands, hooks and MCP servers the version declares.
`created_at`	string	When it was created, RFC 3339 UTC (some older objects use Unix seconds).

Returned by

plugin_marketplace project_record

Was this page helpful?