Versions

List zone package versions

API Reference

Zones

Packages

Versions

List zone package versions

GET/zones/{zone_id}/packages/{package_id}/versions

List zone package versions

Path ParametersExpand Collapse

zone_id: string

package_id: string

minLength1

maxLength70

Query ParametersExpand Collapse

after: optional string

Cursor for forward pagination. Returned in Pagination.after_cursor. Mutually exclusive with before.

minLength1

maxLength255

before: optional string

Cursor for backward pagination. Returned in Pagination.before_cursor. Mutually exclusive with after.

minLength1

maxLength255

limit: optional number

Maximum number of items to return per page.

minimum1

maximum100

Header ParametersExpand Collapse

"X-Client-Request-ID": optional string

formatuuid

ReturnsExpand Collapse

PackageVersionList = object { items, pagination }

items: array of PackageVersion { id, created_at, manifest_sha, 12 more }

id: string

created_at: string

formatdate-time

manifest_sha: string

name: string

owner_type: "platform" or "customer"

Accepts one of the following:

"platform"

"customer"

version: number

formatint32

archived_at: optional string

formatdate-time

created_by: optional string

description: optional string

icon_url: optional string

inputs: optional PackageInputBinding { bindings, schema }

Input binding for a package.

schema constrains install-level inputs. bindings is a CEL expression that assembles the flat input map — static values are CEL literals, install-provided values are pkg.inputs.X references. Evaluated at provisioning time to produce the entities.inputs map for entity bindings.

bindings: optional string

CEL expression assembling the flat input map from static values and install-provided values (referenced via pkg.inputs.X).

Scope:

pkg.inputs — install-supplied values conforming to schema.

schema: optional object { additionalProperties, const, default, 17 more }

A subset of JSON Schema 2020-12 used to describe package input and output shapes.

Supported keywords:

Structural: type, properties, required, items, additionalProperties
Annotations: title, description, default, readOnly, writeOnly
Constraints: pattern, minLength, maxLength, minimum, maximum, minItems, maxItems, enum, const, format

Intentionally unsupported (reject at release time rather than silently ignore):

Schema combinators: allOf, anyOf, oneOf, not
References: $ref, $dynamicRef
patternProperties, propertyNames, unevaluatedProperties
Custom vocabularies and $vocabulary

Dialect: JSON Schema 2020-12 (implied — authors do not include $schema).

additionalProperties: optional unknown

Schema for properties not named in properties.

const: optional unknown

Constant allowed value.

default: optional unknown

Default value (annotation).

description: optional string

Human-readable description (annotation).

enum: optional array of unknown

Enumerated allowed values.

format: optional string

Format hint (e.g., "uri", "uuid", "email", "date-time").

items: optional unknown

Schema for array items.

maximum: optional number

maxItems: optional number

maxLength: optional number

minimum: optional number

minItems: optional number

minLength: optional number

pattern: optional string

properties: optional unknown

Property schemas, keyed by property name.

readOnly: optional boolean

Read-only hint — server-populated, ignored on write.

required: optional array of string

Names of required properties.

title: optional string

Human-readable title (annotation).

type: optional "object" or "array" or "string" or 4 more

The type keyword in JSON Schema 2020-12.

Accepts one of the following:

"object"

"array"

"string"

"integer"

"number"

"boolean"

"null"

writeOnly: optional boolean

Write-only hint (passwords, secrets) — never returned on read.

links: optional array of object { href, rel, properties, 2 more }

href: string

Target reference.

Fragment URIs (#name) reference other entities in the same graph by their local name (the key in the entity map). Absolute paths and URLs reference external resources outside the graph.

rel: string

Link relation type.

properties: optional map[unknown]

Additional metadata keyed by property name.

titles: optional map[string]

Human-readable titles keyed by BCP 47 language tag.

type: optional string

Media type of the target resource (per RFC 7033 section 4.4.4.3). Applies to external hrefs; typically omitted for intra-graph references.

outputs: optional PackageOutputBinding { bindings, schema }

Output binding for a package.

schema describes the flat outputs surfaced on an install. bindings is a CEL expression — a map literal whose keys match schema.properties and whose values project fields out of the resolved entity graph. Evaluated after the provisioner has resolved all entities.

bindings: string

CEL expression source. Must evaluate to a map whose fields match schema.properties.

Scope: entities:

entities.inputs — the package's input values (merged with install inputs at provisioning time).
entities.<name> — resolved entities in the graph, each with href: string and outputs: map<string, dyn>.

schema: object { additionalProperties, const, default, 17 more }

A subset of JSON Schema 2020-12 used to describe package input and output shapes.

Supported keywords:

Structural: type, properties, required, items, additionalProperties
Annotations: title, description, default, readOnly, writeOnly
Constraints: pattern, minLength, maxLength, minimum, maximum, minItems, maxItems, enum, const, format

Intentionally unsupported (reject at release time rather than silently ignore):

Schema combinators: allOf, anyOf, oneOf, not
References: $ref, $dynamicRef
patternProperties, propertyNames, unevaluatedProperties
Custom vocabularies and $vocabulary

Dialect: JSON Schema 2020-12 (implied — authors do not include $schema).

additionalProperties: optional unknown

Schema for properties not named in properties.

const: optional unknown

Constant allowed value.

default: optional unknown

Default value (annotation).

description: optional string

Human-readable description (annotation).

enum: optional array of unknown

Enumerated allowed values.

format: optional string

Format hint (e.g., "uri", "uuid", "email", "date-time").

items: optional unknown

Schema for array items.

maximum: optional number

maxItems: optional number

maxLength: optional number

minimum: optional number

minItems: optional number

minLength: optional number

pattern: optional string

properties: optional unknown

Property schemas, keyed by property name.

readOnly: optional boolean

Read-only hint — server-populated, ignored on write.

required: optional array of string

Names of required properties.

title: optional string

Human-readable title (annotation).

type: optional "object" or "array" or "string" or 4 more

The type keyword in JSON Schema 2020-12.

Accepts one of the following:

"object"

"array"

"string"

"integer"

"number"

"boolean"

"null"

writeOnly: optional boolean

Write-only hint (passwords, secrets) — never returned on read.

properties: optional map[unknown]

Vocabulary-defined metadata properties, keyed by property URN.

Known properties are declared with their schemas; additional properties with custom URNs are permitted via Record<unknown>.

Each property carries x-subject-types indicating which entity types it applies to. Properties with draft/ in the URN are experimental and carry x-internal: true.

tags: optional array of string

pagination: object { after_cursor, before_cursor, total_count }

Cursor-based pagination metadata returned alongside a list of results

after_cursor: string

An opaque cursor used for paginating through a list of results

minLength1

maxLength255

before_cursor: string

An opaque cursor used for paginating through a list of results

minLength1

maxLength255

total_count: optional number

Total number of items across all pages. Only present when the request includes ?expand[]=total_count.

List zone package versions

curl https://zones/$ZONE_ID/packages/$PACKAGE_ID/versions

{
  "items": [
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "manifest_sha": "manifest_sha",
      "name": "name",
      "owner_type": "platform",
      "version": 0,
      "archived_at": "2019-12-27T18:11:19.117Z",
      "created_by": "created_by",
      "description": "description",
      "icon_url": "icon_url",
      "inputs": {
        "bindings": "bindings",
        "schema": {
          "additionalProperties": {},
          "const": {},
          "default": {},
          "description": "description",
          "enum": [
            {}
          ],
          "format": "format",
          "items": {},
          "maximum": 0,
          "maxItems": 0,
          "maxLength": 0,
          "minimum": 0,
          "minItems": 0,
          "minLength": 0,
          "pattern": "pattern",
          "properties": {},
          "readOnly": true,
          "required": [
            "string"
          ],
          "title": "title",
          "type": "object",
          "writeOnly": true
        }
      },
      "links": [
        {
          "href": "href",
          "rel": "rel",
          "properties": {
            "foo": "bar"
          },
          "titles": {
            "foo": "string"
          },
          "type": "type"
        }
      ],
      "outputs": {
        "bindings": "bindings",
        "schema": {
          "additionalProperties": {},
          "const": {},
          "default": {},
          "description": "description",
          "enum": [
            {}
          ],
          "format": "format",
          "items": {},
          "maximum": 0,
          "maxItems": 0,
          "maxLength": 0,
          "minimum": 0,
          "minItems": 0,
          "minLength": 0,
          "pattern": "pattern",
          "properties": {},
          "readOnly": true,
          "required": [
            "string"
          ],
          "title": "title",
          "type": "object",
          "writeOnly": true
        }
      },
      "properties": {
        "foo": "bar"
      },
      "tags": [
        "string"
      ]
    }
  ],
  "pagination": {
    "after_cursor": "x",
    "before_cursor": "x",
    "total_count": 0
  }
}

Returns Examples

{
  "items": [
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "manifest_sha": "manifest_sha",
      "name": "name",
      "owner_type": "platform",
      "version": 0,
      "archived_at": "2019-12-27T18:11:19.117Z",
      "created_by": "created_by",
      "description": "description",
      "icon_url": "icon_url",
      "inputs": {
        "bindings": "bindings",
        "schema": {
          "additionalProperties": {},
          "const": {},
          "default": {},
          "description": "description",
          "enum": [
            {}
          ],
          "format": "format",
          "items": {},
          "maximum": 0,
          "maxItems": 0,
          "maxLength": 0,
          "minimum": 0,
          "minItems": 0,
          "minLength": 0,
          "pattern": "pattern",
          "properties": {},
          "readOnly": true,
          "required": [
            "string"
          ],
          "title": "title",
          "type": "object",
          "writeOnly": true
        }
      },
      "links": [
        {
          "href": "href",
          "rel": "rel",
          "properties": {
            "foo": "bar"
          },
          "titles": {
            "foo": "string"
          },
          "type": "type"
        }
      ],
      "outputs": {
        "bindings": "bindings",
        "schema": {
          "additionalProperties": {},
          "const": {},
          "default": {},
          "description": "description",
          "enum": [
            {}
          ],
          "format": "format",
          "items": {},
          "maximum": 0,
          "maxItems": 0,
          "maxLength": 0,
          "minimum": 0,
          "minItems": 0,
          "minLength": 0,
          "pattern": "pattern",
          "properties": {},
          "readOnly": true,
          "required": [
            "string"
          ],
          "title": "title",
          "type": "object",
          "writeOnly": true
        }
      },
      "properties": {
        "foo": "bar"
      },
      "tags": [
        "string"
      ]
    }
  ],
  "pagination": {
    "after_cursor": "x",
    "before_cursor": "x",
    "total_count": 0
  }
}