picked 0.0.101-next.2 → 0.0.101

package/docs/reference/management-api/schema/cms-models.md

@@ -0,0 +1,1155 @@
+---
+type: reference
+layout: docs
+generated: true
+---
+
+# Cms models schema
+
+The operations and types that `cms-models.graphql` adds to the Management API. See [Management API schema](/reference/management-api/schema) for every domain, the endpoint and authentication.
+
+## Queries
+
+### `contentModels`
+
+List CMS Content Models in a workspace, optionally filtered by category.
+
+```graphql
+contentModels(workspaceId: ID!, category: ContentModelCategory, first: Int, after: String, last: Int, before: String, search: String, sortKey: ContentModelSortKeys = NAME, reverse: Boolean = false): ContentModelConnection! @auth
+```
+
+### `contentModel`
+
+Fetch a CMS Content Model by id.
+
+```graphql
+contentModel(id: ID!): ContentModel @auth
+```
+
+### `contentBlocks`
+
+List CMS Content Blocks in a workspace, optionally filtered by category.
+
+```graphql
+contentBlocks(workspaceId: ID!, category: ContentBlockCategory, first: Int, after: String, last: Int, before: String, search: String, sortKey: ContentBlockSortKeys = NAME, reverse: Boolean = false): ContentBlockConnection! @auth
+```
+
+### `contentBlock`
+
+Fetch a CMS Content Block by id.
+
+```graphql
+contentBlock(id: ID!): ContentBlock @auth
+```
+
+### `contentEntries`
+
+List CMS Content Entries in a workspace, optionally filtered by parent Content Model.
+
+```graphql
+contentEntries(workspaceId: ID!, contentModelId: ID, first: Int, after: String, last: Int, before: String, sortKey: ContentEntrySortKeys = CREATED_AT, reverse: Boolean = false): ContentEntryConnection! @auth
+```
+
+### `contentEntry`
+
+Fetch a CMS Content Entry by id.
+
+```graphql
+contentEntry(id: ID!): ContentEntry @auth
+```
+
+### `assets`
+
+List CMS Assets in a project, with optional text search, MIME-type filtering, and sort.
+
+```graphql
+assets(projectId: ID!, first: Int, after: String, last: Int, before: String, search: String, kind: AssetKind, acceptedMimeTypes: [String!], sortKey: AssetSortKeys = CREATED_AT, reverse: Boolean = true): AssetConnection! @auth
+```
+
+### `asset`
+
+Fetch a CMS Asset by id.
+
+```graphql
+asset(id: ID!): Asset @auth
+```
+
+### `workspaceContentEntryValidation`
+
+Run schema validation across every Content Entry in a workspace and
+report which rows no longer conform. Read-only — does not auto-fix.
+Useful as a pre-publish sanity gate, especially after a Content Block
+schema change. Optionally narrow the sweep to a single Content Model
+with `contentModelId`.
+
+```graphql
+workspaceContentEntryValidation(workspaceId: ID!, contentModelId: ID): WorkspaceContentEntryValidationPayload! @auth
+```
+
+## Mutations
+
+### `contentModelCreate`
+
+Create a new CMS Content Model. Requires scope: `ORGANIZATION_PROJECTS_UPDATE`.
+
+```graphql
+contentModelCreate(input: ContentModelCreateInput!): ContentModelCreatePayload! @auth
+```
+
+### `contentModelUpdate`
+
+Update a CMS Content Model. Returns migration warnings when the schema change drops or coerces dependent Content Entry fields.
+
+```graphql
+contentModelUpdate(input: ContentModelUpdateInput!): ContentModelUpdatePayload! @auth
+```
+
+### `contentModelDelete`
+
+Soft-delete a CMS Content Model. Refuses if dependent Content Entry rows still exist.
+
+```graphql
+contentModelDelete(input: ContentModelDeleteInput!): ContentModelDeletePayload! @auth
+```
+
+### `contentBlockCreate`
+
+Create a new CMS Content Block. Requires scope: `ORGANIZATION_PROJECTS_UPDATE`.
+
+```graphql
+contentBlockCreate(input: ContentBlockCreateInput!): ContentBlockCreatePayload! @auth
+```
+
+### `contentBlockUpdate`
+
+Update a CMS Content Block schema.
+
+```graphql
+contentBlockUpdate(input: ContentBlockUpdateInput!): ContentBlockUpdatePayload! @auth
+```
+
+### `contentBlockDelete`
+
+Soft-delete a CMS Content Block.
+
+```graphql
+contentBlockDelete(input: ContentBlockDeleteInput!): ContentBlockDeletePayload! @auth
+```
+
+### `contentEntryCreate`
+
+Create a new CMS Content Entry against a parent Content Model.
+
+```graphql
+contentEntryCreate(input: ContentEntryCreateInput!): ContentEntryCreatePayload! @auth
+```
+
+### `contentEntryUpdate`
+
+Update a CMS Content Entry's data.
+
+```graphql
+contentEntryUpdate(input: ContentEntryUpdateInput!): ContentEntryUpdatePayload! @auth
+```
+
+### `contentEntryDelete`
+
+Soft-delete a CMS Content Entry. Refuses if a Step references it.
+
+```graphql
+contentEntryDelete(input: ContentEntryDeleteInput!): ContentEntryDeletePayload! @auth
+```
+
+### `assetUploadInit`
+
+Initiate an Asset upload — returns a pre-signed PUT URL plus the allocated asset id.
+
+```graphql
+assetUploadInit(input: AssetUploadInitInput!): AssetUploadInitPayload! @auth
+```
+
+### `assetCommit`
+
+Finalise an Asset upload — captures size, MIME, and intrinsic dimensions for images.
+
+```graphql
+assetCommit(input: AssetCommitInput!): AssetCommitPayload! @auth
+```
+
+### `assetDelete`
+
+Soft-delete an Asset. The underlying storage object is removed best-effort.
+
+```graphql
+assetDelete(input: AssetDeleteInput!): AssetDeletePayload! @auth
+```
+
+## Types
+
+### `ContentModelCategory`
+
+```graphql
+"""
+Content Model schema category. Picking a category determines where the
+Content Model surfaces in the dashboard.
+"""
+enum ContentModelCategory {
+  """Layout configuration for an experience Step."""
+  STEP_LAYOUT
+  """Layout configuration for an experience Page."""
+  PAGE_LAYOUT
+}
+```
+
+### `ContentBlockCategory`
+
+```graphql
+"""
+Content Block schema category. Blocks of a given category can only be
+embedded inside Models / Blocks whose schema declares a
+`ContentBlockFieldDefinition` accepting that category.
+"""
+enum ContentBlockCategory {
+  """A page section (hero, feature list, testimonial, etc.)."""
+  SECTION
+}
+```
+
+### `MigrationWarningType`
+
+```graphql
+"""
+Kind of warning produced by an auto-migration of dependent Content Entries when a parent Content Model's schema changes.
+"""
+enum MigrationWarningType {
+  """
+  A field was dropped from the schema; entry data for that field has been removed.
+  """
+  FIELD_REMOVED
+  """
+  A field's type changed; entry data for that field has been coerced (or set to null if coercion is not possible).
+  """
+  TYPE_CHANGE
+  """A field was renamed and requires manual migration in the dashboard."""
+  RENAME_REQUIRED
+}
+```
+
+### `ContentModel`
+
+```graphql
+"""
+A workspace-scoped CMS Content Model — the structural schema that
+dependent Content Entries conform to. Changing a Content Model's schema
+auto-migrates dependent entries (see `migrationWarnings` on the
+update payload).
+"""
+type ContentModel {
+  """Unique Content Model identifier."""
+  id: ID!
+  """The workspace this Content Model belongs to."""
+  workspace: Workspace!
+  """
+  Category — determines where this Model surfaces in the dashboard. Null for a general-purpose Content Model with no layout role.
+  """
+  category: ContentModelCategory
+  """Display name."""
+  name: String!
+  """Optional human-readable description."""
+  description: String
+  """Stable, human-readable key for SDK consumers."""
+  key: String!
+  """The typed schema describing the entries' shape."""
+  schema: ContentSchema!
+  """Content Entries that instantiate this Content Model."""
+  contentEntries(first: Int, after: String, last: Int, before: String): ContentEntryConnection!
+  """When this Content Model was created."""
+  createdAt: DateTime!
+  """When this Content Model was last updated."""
+  updatedAt: DateTime!
+}
+```
+
+### `ContentModelEdge`
+
+```graphql
+"""Edge type for `ContentModelConnection`."""
+type ContentModelEdge {
+  """Pagination cursor for this edge."""
+  cursor: String!
+  """The Content Model."""
+  node: ContentModel!
+}
+```
+
+### `ContentModelConnection`
+
+```graphql
+"""
+Relay-style connection of Content Models, with both an `edges` list and a flat `nodes` accessor.
+"""
+type ContentModelConnection {
+  """List of Content Model edges."""
+  edges: [ContentModelEdge!]!
+  """Flat list of Content Models, equivalent to `edges[].node`."""
+  nodes: [ContentModel!]!
+  """Pagination metadata."""
+  pageInfo: PageInfo!
+  """Total number of Content Models."""
+  totalCount: Int!
+}
+```
+
+### `ContentBlock`
+
+```graphql
+"""
+A workspace-scoped CMS Content Block — an embeddable schema fragment for
+use inside Content Models.
+
+WARNING: Unlike Content Models, changing a Content Block's schema does
+NOT auto-migrate dependent Content Entries that embed it. Run
+`workspaceContentEntryValidation` as a pre-publish sanity gate after
+modifying a Content Block schema.
+"""
+type ContentBlock {
+  """Unique Content Block identifier."""
+  id: ID!
+  """The workspace this Content Block belongs to."""
+  workspace: Workspace!
+  """
+  Category — restricts which Content Models / Blocks may embed instances of this Block. Null for a general-purpose Content Block with no layout role, which only a `ContentBlockFieldDefinition` that itself sets no category may embed.
+  """
+  category: ContentBlockCategory
+  """Display name."""
+  name: String!
+  """Optional human-readable description."""
+  description: String
+  """Stable, human-readable key for SDK consumers."""
+  key: String!
+  """The typed schema describing block instances' shape."""
+  schema: ContentSchema!
+  """When this Content Block was created."""
+  createdAt: DateTime!
+  """When this Content Block was last updated."""
+  updatedAt: DateTime!
+}
+```
+
+### `ContentBlockEdge`
+
+```graphql
+"""Edge type for `ContentBlockConnection`."""
+type ContentBlockEdge {
+  """Pagination cursor for this edge."""
+  cursor: String!
+  """The Content Block."""
+  node: ContentBlock!
+}
+```
+
+### `ContentBlockConnection`
+
+```graphql
+"""
+Relay-style connection of Content Blocks, with both an `edges` list and a flat `nodes` accessor.
+"""
+type ContentBlockConnection {
+  """List of Content Block edges."""
+  edges: [ContentBlockEdge!]!
+  """Flat list of Content Blocks, equivalent to `edges[].node`."""
+  nodes: [ContentBlock!]!
+  """Pagination metadata."""
+  pageInfo: PageInfo!
+  """Total number of Content Blocks."""
+  totalCount: Int!
+}
+```
+
+### `ContentEntry`
+
+```graphql
+"""
+A workspace-scoped CMS Content Entry — an instance of a parent Content
+Model's schema. The `data` field is strongly typed: a single codec
+encodes / decodes the underlying `jsonb` column against the parent
+schema.
+"""
+type ContentEntry {
+  """Unique Content Entry identifier."""
+  id: ID!
+  """The workspace this Content Entry belongs to."""
+  workspace: Workspace!
+  """Parent Content Model — defines the schema this entry conforms to."""
+  contentModel: ContentModel!
+  """
+  Server-derived display name: the value of the first populated
+  single-line-text field in the parent schema, falling back to the entry
+  `id` when none is present.
+  """
+  title: String!
+  """The entry's data, structurally typed against the parent schema."""
+  data: ContentEntryData!
+  """When this Content Entry was created."""
+  createdAt: DateTime!
+  """When this Content Entry was last updated."""
+  updatedAt: DateTime!
+}
+```
+
+### `ContentEntryEdge`
+
+```graphql
+"""Edge type for `ContentEntryConnection`."""
+type ContentEntryEdge {
+  """Pagination cursor for this edge."""
+  cursor: String!
+  """The Content Entry."""
+  node: ContentEntry!
+}
+```
+
+### `ContentEntryConnection`
+
+```graphql
+"""
+Relay-style connection of Content Entries, with both an `edges` list and a flat `nodes` accessor.
+"""
+type ContentEntryConnection {
+  """List of Content Entry edges."""
+  edges: [ContentEntryEdge!]!
+  """Flat list of Content Entries, equivalent to `edges[].node`."""
+  nodes: [ContentEntry!]!
+  """Pagination metadata."""
+  pageInfo: PageInfo!
+  """Total number of Content Entries."""
+  totalCount: Int!
+}
+```
+
+### `Asset`
+
+```graphql
+"""
+A project-scoped binary asset (image, video, document) stored in the
+`cms-assets` Supabase Storage bucket.
+
+Lifecycle: `assetUploadInit` reserves an id and returns a pre-signed
+PUT URL; the dashboard uploads directly to storage; `assetCommit`
+finalises the row with `sizeBytes`, `mimeType`, and (for images)
+`width` / `height`. Soft-delete via `assetDelete` — the underlying
+object is removed best-effort.
+"""
+type Asset {
+  """Unique Asset identifier. Stable across versions."""
+  id: ID!
+  """The project this Asset belongs to."""
+  project: Project!
+  """Original file name supplied at upload time."""
+  fileName: String!
+  """
+  The Workbench that owns this Asset, when it was authored/uploaded into one. Null for project-level assets.
+  """
+  owner: AssetOwner
+  """MIME type, resolved from the current version."""
+  mimeType: String!
+  """File size in bytes, resolved from the current version."""
+  sizeBytes: Int!
+  """
+  Intrinsic image width in pixels, resolved from the current version — populated only for image MIME types.
+  """
+  width: Int
+  """
+  Intrinsic image height in pixels, resolved from the current version — populated only for image MIME types.
+  """
+  height: Int
+  """
+  The path inside the `cms-assets` bucket for the current version: `cms-assets/<project>/<asset>/<version>/<file_name>`.
+  """
+  storagePath: String!
+  """
+  The proxy URL the dashboard / SDK can use to fetch the current version's binary.
+  """
+  url: String!
+  """
+  The version currently serving this Asset's byte-shaped fields (`url`, `mimeType`, `sizeBytes`, `width`, `height`).
+  """
+  currentVersion: AssetVersion!
+  """Every version of this Asset, oldest first."""
+  versions: [AssetVersion!]!
+  """When this Asset was created (i.e. when `assetCommit` completed)."""
+  createdAt: DateTime!
+}
+```
+
+### `AssetVersion`
+
+```graphql
+"""
+A single byte-state of an Asset. Immutable versions (flagged at publish) are
+never overwritten — the next edit forks a new version instead of reusing it.
+"""
+type AssetVersion {
+  """Unique AssetVersion identifier."""
+  id: ID!
+  """MIME type captured at commit time."""
+  mimeType: String!
+  """File size in bytes."""
+  sizeBytes: Int!
+  """Intrinsic image width in pixels — populated only for image MIME types."""
+  width: Int
+  """
+  Intrinsic image height in pixels — populated only for image MIME types.
+  """
+  height: Int
+  """
+  True once this version has been referenced by a publish — never overwritten again.
+  """
+  isImmutable: Boolean!
+  """
+  Lowercase hex SHA-256 of this version's stored bytes, computed by the server
+  during `assetCommit`. Null for versions committed before content hashing, and
+  while an upload that overwrites this version in place is not yet committed.
+  """
+  sha256: String
+  """
+  The proxy URL the dashboard / SDK can use to fetch this version's binary.
+  """
+  url: String!
+  """When this version was created."""
+  createdAt: DateTime!
+}
+```
+
+### `AssetOwner`
+
+```graphql
+"""Identifies the Workbench that owns an Asset."""
+type AssetOwner {
+  """The owner kind, currently always `"workbench"`."""
+  type: String!
+  """The owning Workbench id."""
+  id: String!
+}
+```
+
+### `AssetEdge`
+
+```graphql
+"""Edge type for `AssetConnection`."""
+type AssetEdge {
+  """Pagination cursor for this edge."""
+  cursor: String!
+  """The Asset."""
+  node: Asset!
+}
+```
+
+### `AssetConnection`
+
+```graphql
+"""
+Relay-style connection of Assets, with both an `edges` list and a flat `nodes` accessor.
+"""
+type AssetConnection {
+  """List of Asset edges."""
+  edges: [AssetEdge!]!
+  """Flat list of Assets, equivalent to `edges[].node`."""
+  nodes: [Asset!]!
+  """Pagination metadata."""
+  pageInfo: PageInfo!
+  """Total number of Assets."""
+  totalCount: Int!
+}
+```
+
+### `MigrationWarning`
+
+```graphql
+"""
+A single Content-Entry-migration warning produced when a parent Content
+Model's schema changes and dependent entries' data needed to be
+auto-coerced or dropped.
+"""
+type MigrationWarning {
+  """The Content Entry whose data was affected."""
+  contentEntryId: ID!
+  """JSON-Pointer-style path into the entry data (e.g. `$.title`)."""
+  fieldPath: String!
+  """Kind of warning."""
+  warningType: MigrationWarningType!
+  """
+  Stringified previous value, when applicable (truncated for large blobs).
+  """
+  oldValue: String
+}
+```
+
+### `WorkspaceContentEntryValidationPayload`
+
+```graphql
+"""
+Result of validating every Content Entry in a workspace against its
+parent Content Model schema (recursively walking embedded Content Block
+instances).
+
+Useful as a pre-publish sanity gate, especially after a Content Block
+schema change (which does NOT auto-migrate dependent Content Entries
+the way Content Model schema changes do).
+"""
+type WorkspaceContentEntryValidationPayload {
+  """Total Content Entry rows visited."""
+  totalCount: Int!
+  """Rows whose `data` blob conforms cleanly to its Content Model schema."""
+  validCount: Int!
+  """Rows with at least one validation error."""
+  invalidCount: Int!
+  """
+  Per-Content-Entry outcomes, in DB-order (matches `contentEntries` query ordering).
+  """
+  outcomes: [ContentEntryValidationOutcome!]!
+}
+```
+
+### `ContentEntryValidationOutcome`
+
+```graphql
+"""A single Content Entry's validation outcome."""
+type ContentEntryValidationOutcome {
+  """
+  Identifier for the Content Entry — always present, even when `contentEntry` is null due to a soft-delete race.
+  """
+  contentEntryId: ID!
+  """
+  Identifier for the parent Content Model — always present, even when `contentModel` is null due to a soft-delete race.
+  """
+  contentModelId: ID!
+  """
+  The Content Entry that was validated. Null if it was concurrently soft-deleted.
+  """
+  contentEntry: ContentEntry
+  """The parent Content Model. Null if it was concurrently soft-deleted."""
+  contentModel: ContentModel
+  """
+  Snapshot of the parent Content Model name at validation time — non-null even if the parent was concurrently soft-deleted.
+  """
+  contentModelName: String!
+  """
+  Whether the Content Entry data conforms to the parent Content Model schema.
+  """
+  valid: Boolean!
+  """Per-field validation errors. Empty when `valid` is true."""
+  errors: [ContentEntryValidationError!]!
+}
+```
+
+### `ContentEntryValidationError`
+
+```graphql
+"""
+A single Content Entry validation error pinned to a path inside the `data` blob.
+"""
+type ContentEntryValidationError {
+  """
+  JSON-Pointer-style path inside the Content Entry data, e.g. `$.title` or `$.sections[0].headline`.
+  """
+  path: String!
+  """Human-readable error message."""
+  message: String!
+}
+```
+
+### `ContentModelCreateInput`
+
+```graphql
+"""Input for `contentModelCreate`."""
+input ContentModelCreateInput {
+  """Workspace ID to create the Content Model in."""
+  workspaceId: ID!
+  """
+  Category — determines where the Model surfaces in the dashboard. Omit for a general-purpose Content Model with no layout role.
+  """
+  category: ContentModelCategory
+  """Display name."""
+  name: String!
+  """Optional human-readable description."""
+  description: String
+  """Stable, human-readable key for SDK consumers."""
+  key: String!
+  """Initial schema."""
+  schema: ContentSchemaInput!
+}
+```
+
+### `ContentModelCreatePayload`
+
+```graphql
+"""Payload returned by `contentModelCreate`."""
+type ContentModelCreatePayload {
+  """The created Content Model."""
+  contentModel: ContentModel
+}
+```
+
+### `ContentModelUpdateInput`
+
+```graphql
+"""Input for `contentModelUpdate`. Omit a field to leave it unchanged."""
+input ContentModelUpdateInput {
+  """Content Model ID."""
+  id: ID!
+  """New display name."""
+  name: String
+  """New description. Omit to leave unchanged."""
+  description: String
+  """
+  New schema. Schema changes auto-migrate dependent Content Entries; affected paths are returned in `migrationWarnings`.
+  """
+  schema: ContentSchemaInput
+}
+```
+
+### `ContentModelUpdatePayload`
+
+```graphql
+"""
+Payload returned by `contentModelUpdate`. `migrationWarnings` lists
+every per-Content-Entry coercion or field-removal performed when the
+schema change required it.
+"""
+type ContentModelUpdatePayload {
+  """The updated Content Model."""
+  contentModel: ContentModel
+  """
+  Per-Content-Entry warnings emitted when the schema change dropped or coerced fields.
+  """
+  migrationWarnings: [MigrationWarning!]!
+}
+```
+
+### `ContentModelDeleteInput`
+
+```graphql
+"""
+Input for `contentModelDelete`. Refused if dependent Content Entry rows still exist.
+"""
+input ContentModelDeleteInput {
+  """Content Model ID."""
+  id: ID!
+}
+```
+
+### `ContentModelDeletePayload`
+
+```graphql
+"""Payload returned by `contentModelDelete`."""
+type ContentModelDeletePayload {
+  """ID of the deleted Content Model."""
+  contentModelId: ID
+}
+```
+
+### `ContentBlockCreateInput`
+
+```graphql
+"""Input for `contentBlockCreate`."""
+input ContentBlockCreateInput {
+  """Workspace ID to create the Content Block in."""
+  workspaceId: ID!
+  """
+  Category — restricts where instances of this Block may be embedded. Omit for a general-purpose Content Block with no layout role.
+  """
+  category: ContentBlockCategory
+  """Display name."""
+  name: String!
+  """Optional human-readable description."""
+  description: String
+  """Stable, human-readable key for SDK consumers."""
+  key: String!
+  """Initial schema."""
+  schema: ContentSchemaInput!
+}
+```
+
+### `ContentBlockCreatePayload`
+
+```graphql
+"""Payload returned by `contentBlockCreate`."""
+type ContentBlockCreatePayload {
+  """The created Content Block."""
+  contentBlock: ContentBlock
+}
+```
+
+### `ContentBlockUpdateInput`
+
+```graphql
+"""Input for `contentBlockUpdate`. Omit a field to leave it unchanged."""
+input ContentBlockUpdateInput {
+  """Content Block ID."""
+  id: ID!
+  """New display name."""
+  name: String
+  """New description. Omit to leave unchanged."""
+  description: String
+  """
+  New schema. WARNING: changing a Block schema does NOT auto-migrate dependent Content Entries — run `workspaceContentEntryValidation` to find drift.
+  """
+  schema: ContentSchemaInput
+}
+```
+
+### `ContentBlockUpdatePayload`
+
+```graphql
+"""Payload returned by `contentBlockUpdate`."""
+type ContentBlockUpdatePayload {
+  """The updated Content Block."""
+  contentBlock: ContentBlock
+}
+```
+
+### `ContentBlockDeleteInput`
+
+```graphql
+"""Input for `contentBlockDelete`."""
+input ContentBlockDeleteInput {
+  """Content Block ID."""
+  id: ID!
+}
+```
+
+### `ContentBlockDeletePayload`
+
+```graphql
+"""Payload returned by `contentBlockDelete`."""
+type ContentBlockDeletePayload {
+  """ID of the deleted Content Block."""
+  contentBlockId: ID
+}
+```
+
+### `ContentEntryCreateInput`
+
+```graphql
+"""Input for `contentEntryCreate`."""
+input ContentEntryCreateInput {
+  """
+  Parent Content Model id — the entry's data must conform to this Model's schema.
+  """
+  contentModelId: ID!
+  """The entry's data, structurally typed against the parent schema."""
+  data: ContentEntryDataInput!
+}
+```
+
+### `ContentEntryCreatePayload`
+
+```graphql
+"""Payload returned by `contentEntryCreate`."""
+type ContentEntryCreatePayload {
+  """The created Content Entry."""
+  contentEntry: ContentEntry
+}
+```
+
+### `ContentEntryUpdateInput`
+
+```graphql
+"""
+Input for `contentEntryUpdate`. The entire `data` blob is replaced; partial updates are not supported.
+"""
+input ContentEntryUpdateInput {
+  """Content Entry ID."""
+  id: ID!
+  """New entry data — must conform to the parent Content Model's schema."""
+  data: ContentEntryDataInput!
+}
+```
+
+### `ContentEntryUpdatePayload`
+
+```graphql
+"""Payload returned by `contentEntryUpdate`."""
+type ContentEntryUpdatePayload {
+  """The updated Content Entry."""
+  contentEntry: ContentEntry
+}
+```
+
+### `ContentEntryDeleteInput`
+
+```graphql
+"""Input for `contentEntryDelete`. Refused if a Step references it."""
+input ContentEntryDeleteInput {
+  """Content Entry ID."""
+  id: ID!
+}
+```
+
+### `ContentEntryDeletePayload`
+
+```graphql
+"""Payload returned by `contentEntryDelete`."""
+type ContentEntryDeletePayload {
+  """ID of the deleted Content Entry."""
+  contentEntryId: ID
+}
+```
+
+### `AssetUploadInitInput`
+
+```graphql
+"""
+Input for `assetUploadInit` — reserve an Asset id and obtain a pre-signed PUT
+URL. Passing `assetId` targets an existing Asset for a new write: the write
+overwrites the current version in place while it is mutable, or forks a new
+version once the current version has been published (copy-on-write).
+
+Passing `sha256` on a new project-level upload (no `assetId`, no `workbenchId`)
+deduplicates it: when a non-deleted, project-level (not Workbench-owned) Asset
+in the same project already has a version with those bytes, the payload returns that Asset and version with
+`deduplicated: true` and no `uploadUrl`, and there is nothing to upload or
+commit.
+"""
+input AssetUploadInitInput {
+  """Project to upload the Asset into."""
+  projectId: ID!
+  """
+  Original file name. Stored verbatim — used for display and in the storage path.
+  """
+  fileName: String!
+  """
+  MIME type the dashboard expects to upload. Must match the uploaded bytes' content-type.
+  """
+  contentType: String!
+  """
+  Targets an existing Asset for a new write (overwrite or fork). Omit to create a new Asset.
+  """
+  assetId: ID
+  """The Workbench this upload belongs to."""
+  workbenchId: ID
+  """
+  Logical path within the Workbench (for example `drafts/outline-v1.md`).
+  When given, the server derives `fileName` from the segment after the last `/`.
+  """
+  path: String
+  """
+  Hex SHA-256 of the bytes the client will upload (64 characters, either case).
+  Enables deduplication for new project-level uploads. Pass the same value to
+  `assetCommit`, which rejects bytes that hash differently.
+  """
+  sha256: String
+}
+```
+
+### `AssetUploadInitPayload`
+
+```graphql
+"""
+Payload returned by `assetUploadInit`.
+
+When `deduplicated` is false, PUT the bytes to `uploadUrl` and then call
+`assetCommit` with `assetId`, `versionId` and `storagePath`. When it is true,
+`assetId` and `versionId` name an existing committed version whose bytes match
+the declared `sha256`; reference them directly, with no upload and no commit.
+"""
+type AssetUploadInitPayload {
+  """
+  Pre-signed PUT URL the client uploads to. Null when `deduplicated` is true.
+  """
+  uploadUrl: String
+  """
+  The asset id — pre-allocated for a new Asset, the `assetId` passed in for an existing one, or the Asset owning the matching version when deduplicated. The dashboard MUST pass this to `assetCommit` when it uploads.
+  """
+  assetId: ID!
+  """
+  The version id this upload targets, or the matching existing version when deduplicated. The dashboard MUST pass this to `assetCommit` when it uploads.
+  """
+  versionId: ID!
+  """
+  Storage path the URL writes to (echoed back to the commit step), or the matching version's path when deduplicated.
+  """
+  storagePath: String!
+  """
+  True when the project already holds the declared bytes and nothing needs uploading.
+  """
+  deduplicated: Boolean!
+}
+```
+
+### `AssetCommitInput`
+
+```graphql
+"""
+Input for `assetCommit` — finalise an upload by recording `sizeBytes`, `mimeType`, and intrinsic dimensions.
+"""
+input AssetCommitInput {
+  """Project the Asset belongs to."""
+  projectId: ID!
+  """Asset id reserved by `assetUploadInit`."""
+  assetId: ID!
+  """Version id reserved by `assetUploadInit`."""
+  versionId: ID!
+  """Original file name (matches the `assetUploadInit` value)."""
+  fileName: String!
+  """Storage path returned by `assetUploadInit`."""
+  storagePath: String!
+  """
+  The Workbench this upload belongs to. Recorded as the Asset's owner only when the Asset document is first created.
+  """
+  workbenchId: ID
+  """
+  Logical path within the Workbench (for example `drafts/outline-v1.md`).
+  When given with `workbenchId`, stored on `workbench_assets.path`; `fileName` is
+  derived from the segment after the last `/` when omitted.
+  """
+  path: String
+  """
+  Hex SHA-256 the client declared to `assetUploadInit`. When given, the commit
+  returns a `HASH_MISMATCH` user error, and records no version, if the stored
+  bytes hash to anything else.
+  """
+  sha256: String
+}
+```
+
+### `AssetCommitPayload`
+
+```graphql
+"""Payload returned by `assetCommit`."""
+type AssetCommitPayload {
+  """
+  The committed Asset, now ready to be referenced from Content Entry data. Null when a `userError` was returned.
+  """
+  asset: Asset
+  """Errors that stopped the commit. Empty on success."""
+  userErrors: [AssetCommitUserError!]!
+}
+```
+
+### `AssetCommitErrorCode`
+
+```graphql
+"""Machine-readable error codes for `assetCommit`."""
+enum AssetCommitErrorCode {
+  """The stored bytes do not hash to the `sha256` given in the input."""
+  HASH_MISMATCH
+}
+```
+
+### `AssetCommitUserError`
+
+```graphql
+"""User-facing error for `assetCommit`."""
+type AssetCommitUserError {
+  """Path to the offending input field, if applicable."""
+  field: [String!]
+  """Human-readable error message."""
+  message: String!
+  """Machine-readable error code."""
+  code: AssetCommitErrorCode!
+}
+```
+
+### `AssetDeleteInput`
+
+```graphql
+"""
+Input for `assetDelete` — soft-deletes the Asset row. The underlying storage object is removed best-effort.
+"""
+input AssetDeleteInput {
+  """Asset ID."""
+  id: ID!
+}
+```
+
+### `AssetDeletePayload`
+
+```graphql
+"""Payload returned by `assetDelete`."""
+type AssetDeletePayload {
+  """ID of the deleted Asset."""
+  assetId: ID
+}
+```
+
+### `ContentBlockSortKeys`
+
+```graphql
+"""
+Sort keys for `contentBlocks(...)`. Pair with `reverse: true` to flip the order.
+"""
+enum ContentBlockSortKeys {
+  """Sort by `name` (alphabetical)."""
+  NAME
+  """Sort by `createdAt`."""
+  CREATED_AT
+  """Sort by `updatedAt`."""
+  UPDATED_AT
+}
+```
+
+### `ContentModelSortKeys`
+
+```graphql
+"""
+Sort keys for `contentModels(...)`. Pair with `reverse: true` to flip the order.
+"""
+enum ContentModelSortKeys {
+  """Sort by `name` (alphabetical)."""
+  NAME
+  """Sort by `createdAt`."""
+  CREATED_AT
+  """Sort by `updatedAt`."""
+  UPDATED_AT
+}
+```
+
+### `ContentEntrySortKeys`
+
+```graphql
+"""
+Sort keys for `contentEntries(...)`. Entries have no name; pair with `reverse: true` to flip the order.
+"""
+enum ContentEntrySortKeys {
+  """Sort by `createdAt`."""
+  CREATED_AT
+  """Sort by `updatedAt`."""
+  UPDATED_AT
+}
+```
+
+### `AssetSortKeys`
+
+```graphql
+"""
+Sort keys for `assets(...)`. Pair with `reverse: true` to flip the order.
+"""
+enum AssetSortKeys {
+  """Sort by `fileName` (alphabetical)."""
+  NAME
+  """Sort by `createdAt` (upload time)."""
+  CREATED_AT
+}
+```
+
+### `AssetKind`
+
+```graphql
+"""
+A media-type bucket for browsing the asset library, matched against the current version's MIME type.
+"""
+enum AssetKind {
+  """`image/*`."""
+  IMAGE
+  """`video/*`."""
+  VIDEO
+  """`audio/*`."""
+  AUDIO
+  """Anything that is not an image, video, audio, or recognised archive."""
+  DOCUMENT
+  """A recognised archive type (zip, rar, gzip, 7z, tar)."""
+  ARCHIVE
+}
+```