Skip to main content

ProposalPage

Bounded advisory listing; each selected proposal must be freshly reviewed.

proposals object[]required

Up to sixteen retained proposal summaries.

Possible values: <= 16

  • Array [
    • reference objectrequired

    Exact journal lookup reference.

    pluginIdPluginid (string)required

    Exact installed managed plugin identity.

    Possible values: Value must match regular expression ^managed\.[a-z0-9][a-z0-9._-]{0,80}$

    nodeIdNodeid (string)required

    Stable installed node identity.

    Possible values: non-empty and <= 128 characters, Value must match regular expression ^[a-zA-Z0-9._:@-]+$

    proposalIdProposalid (string)required

    Provider-owned opaque identifier, never a path or canonical input.

    Possible values: non-empty and <= 128 characters, Value must match regular expression ^[a-zA-Z0-9._:@-]+$

    proposalDigestProposaldigest (string)required

    Digest of the provider's complete immutable proposal intent.

    Possible values: Value must match regular expression ^[a-f0-9]{64}$

    summarySummary (string)required

    Plain-text operation, selected resources and spending summary.

    Possible values: non-empty and <= 1024 characters

    expiresAtExpiresat (integer)required

    Proposal expiry as UTC Unix seconds.

    Possible values: > 0

    stateState (string)required

    Observed journal state; execution_recorded does not imply success.

    Possible values: [pending_approval, approved, execution_recorded, expired, unavailable]

  • ]
    • nextOffset object

    Next listing offset, or null at the current end; concurrent changes may move entries.

    anyOf
    integer

    Possible values: >= 1 and <= 127

    ProposalPage
    {
      "proposals": [
        {
          "reference": {
            "pluginId": "string",
            "nodeId": "string",
            "proposalId": "string",
            "proposalDigest": "string"
          },
          "summary": "string",
          "expiresAt": 0,
          "state": "pending_approval"
        }
      ],
      "nextOffset": 0
    }