Skip to content
Reference: all pages

Reference

Intent envelope reference

The ECZ-ID Intent (ecz.intent.v1): the authorised envelope of what an actor may do, field by field, and the reference that travels with a proposed action.

Core contract

ECZ-ID Intent is live and operated in the TrustOps Dashboard. This is the Core representation shown to the authenticated owner. It is not served by a public endpoint, and the public Intent disclosure is not enabled.

ECZ-ID Intent today · measured 2026-10-10

Commercial capability
Available through TrustOpsPlans are sold in TrustOps.
Signed-in operation
LiveCreated and authorised by the account holder, signed in, in the TrustOps Dashboard.
Public developer interface
NoneThere is no public developer API. Public Intent disclosure is defined in Core and not enabled.
Contract
Core contractDefined and held by ECZ-ID Core. Documented so you can integrate; Core serves no public schema or endpoint for it.
Version
ecz.intent.v1
Machine-readable
Schema index entry

Accountability Chain:Intent

Two shapes

The Intent
ecz.intent.v1: the standing, authorised envelope. Versioned; every change is recorded in delta[].
The Intent reference
{ "intent_id": "INT-…", "version": 3 }: what travels with one proposed action.

Fields

FieldTypeNotes
schemaconstecz.intent.v1
intent_idstring^INT-[0-9A-Z]{20}$
versioninteger ≥ 1A new version needs fresh authorisation
parent_ecz_idstringThe operating organisation
actorobjectkind: ECZ_PASSPORT, the child ecz_id, and family: AGENT, MCP, PLUGIN, API, IOT, SDK or SERVICE_WORKLOAD
purpose_versioninteger or nullOptional
objective_summarystringAt most 2,000 characters
targetsarrayAt most 32 ECZ-IDs
constraintsobjectSee below
windowobjectnot_before, expires_at (UTC)
delegationobjectmay_delegate, max_depth 0–4
parent_intentobject or null{ intent_id, version }
stateenumSee states
authorisationobject or nullSee authority and delegation
sandboxbooleanA sandbox Intent never authorises production
proofobjectdigest (sha256:, with its canonicalisation) and signature (null today)
publicationobjectpublished: whether the owner chose to disclose it publicly
deltaarrayOne entry per change: version, time, change, principal, changed paths
created_at, updated_atUTC timestamps

constraints

FieldShape
actions, resources, destinations{ permitted: [], excluded: [] }, up to 64 patterns each. Globs; * is the only wildcard. Excluded wins.
parametersUp to 32 rules { path, op, value }; op is one of eq, neq, lt, lte, gt, gte, in, not_in, glob, present, absent
financialnull or { currency, max_per_action, max_total }
data_classes_deniedUp to 32 data classes
approvalnull or { required_for: [], above_amount }
ratenull or { max_actions, window_seconds }
counterpartyOptional { counterparty_ecz_id, target_surface_refs, required_binding_types, required_dci_state: BOUND, max_proof_age_seconds, on_change }; on_change is RE_RESOLVE, REQUIRE_APPROVAL or FORBID

States

StateIn force
DRAFTNo
APPROVAL_REQUIREDNo: submitted by a member, awaiting an owner or admin
AUTHORISEDNo
ACTIVEYes. The only state in force.
COMPLETEDNo
EXPIREDNo
REVOKEDNo
SUPERSEDEDNo

Illustrative shape

jsonIllustrative only. Placeholder identifiers; abridged. Not a response from any endpoint.
{
  "schema": "ecz.intent.v1",
  "intent_id": "INT-0000000000EXAMPLE0",
  "version": 1,
  "parent_ecz_id": "ECZ-GB-EXAMPL",
  "actor": {
    "kind": "ECZ_PASSPORT",
    "ecz_id": "ECZ-GB-EXAMPL::AGENT_PASSPORT-AB12CD",
    "family": "AGENT"
  },
  "objective_summary": "Pay approved supplier invoices",
  "constraints": {
    "actions": { "permitted": ["invoice:pay"], "excluded": ["invoice:pay_new_payee"] },
    "financial": { "currency": "GBP", "max_per_action": 500, "max_total": 5000 },
    "data_classes_denied": ["card_data"],
    "approval": { "required_for": [], "above_amount": 250 },
    "rate": { "max_actions": 50, "window_seconds": 86400 }
  },
  "window": { "not_before": "2026-10-12T00:00:00Z", "expires_at": "2026-10-19T00:00:00Z" },
  "delegation": { "may_delegate": false, "max_depth": 0 },
  "parent_intent": null,
  "state": "ACTIVE",
  "sandbox": false,
  "publication": { "published": false }
}

This page is explanation, not authority. Current state is only ever the live Resolver record. Live facts on this page were measured read-only on 2026-10-10.