content
engine-dmo content: Content operations: list, get, create, update, trash, restore, hold, purge, clone, reproject, reindex, publish, structure, variant, prune-revisions, legal-hold. Every subcommand, argument and flag.
Content operations: list, get, create, update, trash, restore, hold, purge, clone, reproject, reindex, publish, structure, variant, prune-revisions, legal-hold.
There is no command to unpublish a locale or to schedule a publish: content publish publishes now. Unpublish or schedule in the admin, or through the content MCP (its publish tool takes publish_at, and unpublish takes a redirect destination). A seed can leave a document scheduled with schedule:. Taking a page down from the terminal is content trash, which takes --redirect (parent, a path or none) when a locale is live.
| Command | What it does |
|---|---|
engine-dmo content clone | Copy a document as a new draft on a site |
engine-dmo content create | Create a document from a JSON object of field values, validated as the admin validates a save; --publish runs the publish checks |
engine-dmo content export | Export a type’s documents on a site, or a selection, as JSON or CSV with their working values per locale; audited |
engine-dmo content get | A document’s working and published values by field handle, and its status per locale |
engine-dmo content hold | Keep a trashed document until someone decides, or --until a date, or --release |
engine-dmo content import | Import a JSON export file as drafts, matched by id or slug, never published; --dry-run writes nothing |
engine-dmo content legal-hold | Place a legal hold on a document, keeping every revision and refusing its purge; --release removes it |
engine-dmo content list | List documents, one line each |
engine-dmo content prune-revisions | Run the revision retention sweep now, resuming an interrupted run; --dry-run says what would go |
engine-dmo content publish | Publish a locale through the publish checks, or every locale whose checks pass with --all-locales |
engine-dmo content purge | Hard delete, irreversible; --expired runs the nightly sweep now |
engine-dmo content reindex | Queue search indexing for every published document, on every site and locale |
engine-dmo content reproject | Rewrite the projection index, relations, shapes and occurrences under the current schema |
engine-dmo content restore | Reinstate, re-resolve URIs, republish what was live |
engine-dmo content structure | Override how one document holds a container field, shared or per_locale; audited |
engine-dmo content trash | Soft delete; --redirect is required when any locale is live |
engine-dmo content update | Merge field values over a locale’s working revision and save; only the fields given change, and null clears one |
engine-dmo content variant set | Move documents to another entry variant, by --id or every one of --type in --from; values the new variant does not show are set aside, not deleted |
engine-dmo content clone
Copy a document as a new draft on a site.
engine-dmo content clone [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--no-tags | bool | leave taggings behind | |
--site | string | target site (default: the source’s owner site) | |
--title | string | title of the copy in the source locale |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content create
Create a document from a JSON object of field values, validated as the admin validates a save; --publish runs the publish checks.
engine-dmo content create [values] [flags] | Argument | Required | Repeatable |
|---|---|---|
values | no | no |
| Flag | Type | Default | Meaning |
|---|---|---|---|
--data | string | the field values as a JSON object, or - for standard input | |
--locale | string | locale of the values (default: the source locale) | |
--publish | bool | publish the locale through the publish checks | |
--site | string | owner site (default: the default site) | |
--type | string | type key |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo content export
Export a type’s documents on a site, or a selection, as JSON or CSV with their working values per locale; audited.
engine-dmo content export [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--format | string | json | json | csv |
--id | string, repeatable | a selection: only this document (repeatable) | |
--ids-from | string | a selection: a file with one document id a line | |
--locale | string, repeatable | only this locale (repeatable); every locale when left out | |
--out | string | file to write; standard output when empty or - | |
--site | string | site key (default: the default site) | |
--type | string | type key |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo content get
A document’s working and published values by field handle, and its status per locale.
engine-dmo content get <id> [flags] | Argument | Required | Repeatable |
|---|---|---|
id | yes | no |
| Flag | Type | Default | Meaning |
|---|---|---|---|
--locale | string | one locale (default: every locale the document has) |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo content hold
Keep a trashed document until someone decides, or --until a date, or --release.
engine-dmo content hold [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--release | bool | restore the retention window from now | |
--until | string | purge on this date (YYYY-MM-DD) |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content import
Import a JSON export file as drafts, matched by id or slug, never published; --dry-run writes nothing.
engine-dmo content import [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--dry-run | bool | say what would happen to each locale and write nothing | |
--file | string | the JSON file an export wrote; - reads standard input | |
--match | string | id | id | slug: how a document in the file finds the one it updates |
--site | string | site key (default: the default site) |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo content legal-hold
Place a legal hold on a document, keeping every revision and refusing its purge; --release removes it.
engine-dmo content legal-hold [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--id | string | document id | |
--reason | string | why the document is held; recorded with the hold and in the audit log | |
--release | bool | remove the hold | |
--until | string | the last day the hold protects (YYYY-MM-DD); omitted, it holds until released |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content list
List documents, one line each.
engine-dmo content list [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--locale | string | locale code | |
--site | string | site key (default: the default site) | |
--status | string | draft | in_review | published | scheduled | archived | |
--trashed | bool | list the trash instead | |
--type | string | type key |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo content prune-revisions
Run the revision retention sweep now, resuming an interrupted run; --dry-run says what would go.
engine-dmo content prune-revisions [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--dry-run | bool | delete nothing and print what would go |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo content publish
Publish a locale through the publish checks, or every locale whose checks pass with --all-locales.
engine-dmo content publish [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--all-locales | bool | every locale with a working revision, source first; a locale whose checks fail is skipped and named | |
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--locale | string | locale code | |
--no-redirect | string | the reason a changed live path gets no redirect; audited | |
--no-shared | bool | leave the shared draft unpublished |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content purge
Hard delete, irreversible; --expired runs the nightly sweep now.
engine-dmo content purge [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--expired | bool | every trashed document past its purge_after | |
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--yes | bool | confirm |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content reindex
Queue search indexing for every published document, on every site and locale.
engine-dmo content reindex [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--type | string | type key (default: every type) |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content reproject
Rewrite the projection index, relations, shapes and occurrences under the current schema.
engine-dmo content reproject [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--field | string | a field of --type; the whole document is reprojected, the flag checks the field exists | |
--type | string | type key (default: every type) |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content restore
Reinstate, re-resolve URIs, republish what was live.
engine-dmo content restore [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--slug-on-conflict | string | suffix | suffix | fail |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content structure
Override how one document holds a container field, shared or per_locale; audited.
engine-dmo content structure [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--field | string | a top-level repeater or blocks field | |
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--mode | string | per_locale | shared | per_locale |
--reason | string | why this document differs; recorded in the audit log |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content trash
Soft delete; --redirect is required when any locale is live.
engine-dmo content trash [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--hold | bool | clear purge_after | |
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--redirect | string | parent | /path | none |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo content update
Merge field values over a locale’s working revision and save; only the fields given change, and null clears one.
engine-dmo content update <id> [values] [flags] | Argument | Required | Repeatable |
|---|---|---|
id | yes | no |
values | no | no |
| Flag | Type | Default | Meaning |
|---|---|---|---|
--data | string | the field values as a JSON object, or - for standard input | |
--locale | string | locale to save (default: the source locale) | |
--publish | bool | publish the locale through the publish checks |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo content variant set
Move documents to another entry variant, by --id or every one of --type in --from; values the new variant does not show are set aside, not deleted.
engine-dmo content variant set [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--dry-run | bool | write nothing and say what each move would set aside | |
--from | string | move every live document of --type in this variant (the default variant also holds documents naming none) | |
--id | string, repeatable | document id (repeatable) | |
--ids-from | string | file with one id per line | |
--site | string | with --from, only documents this site owns | |
--to | string | the variant to move to | |
--type | string | type key, with --from |
--json prints the text output in the JSON envelope. Runs in a project.