TemplateListItem

Summary of a template as returned in list responses. Carries identity, audit metadata, and the template's interface (inputs the caller must supply, plus a slim role list for display). Implementation details (asset content reference, role binding expressions, output transforms) are omitted — fetch the full template to inspect them.

contentHash
Type: string
required

Stable hash of the resource's content. Recomputed on every write (Create, Update, Publish), so it's available for both drafts and published versions. Useful for change detection — compare hashes across two snapshots (e.g. "did the draft actually change?" or "is the draft different from the latest published version?").
createdAt
Type: stringFormat: date-time
required

When this version was created.
createdBy
Type: object
required

Actor who created this version.
- id
  Type: string
  required
  
  Stable ID for the actor (UUID for users; the API key's keyId for service accounts).
- type
  Type: stringenum
  required
  values
  user
  api_key
metadata
Type: object
required

The resource's identity and human-facing labels. Shared shape across all five resource kinds (blueprints, templates, schemas, assets, functions). The pair (key, version) is the canonical handle for any resource within a namespace.
- key
  Type: string Pattern: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
  required
  
  Caller-supplied identifier, unique within the namespace per kind. Stable across versions — a blueprint's key doesn't change when you publish a new version. Snake_case; must start with a lowercase letter.
- name
  Type: string
  max length:
  200
  required
  
  Human-readable display name shown in Studio, list responses, and audit trails (max 200 chars).
- version
  Type: string
  required
  
  Either draft (editable; only one draft per key at a time) or a semver like 1.2.0 (immutable once published). On create you choose: pass draft to iterate, or a semver to publish directly.
- description
  Type: string
  max length:
  1000
  
  Optional longer-form description. Helps both humans and AI assistants pick the right resource when browsing the catalog (max 1000 chars).
- labels
  Type: object
  
  Arbitrary key/value tags for categorization and filtering — e.g. { "team": "people-ops", "env": "prod" }. Filterable on list endpoints via ?labels[key]=value.
spec
Type: object
required

Slim summary of the template's interface — enough to identify the template without the full payload.
- inputs
  Type: array object[] · Input[]
  
  Entity inputs the template takes.
- roles
  Type: array object[]
  
  Slim role list — identity plus the role's output schema reference (the type of data the role produces when signed). Binding expressions and the JSONata output transform are returned by the full template endpoint.
updatedAt
Type: stringFormat: date-time
required

When this version was last modified (drafts only — published versions are immutable).
publishedAt
Type: stringFormat: date-time

When this version was published. Absent on drafts.
publishedBy
Type: object

Actor who published this version. Absent on drafts.
- id
  Type: string
  required
  
  Stable ID for the actor (UUID for users; the API key's keyId for service accounts).
- type
  Type: stringenum
  required
  values
  user
  api_key