Nimbu Developer Docs
CLICommand reference

Channels

Generated reference for nimbu channels

Generated from the CLI command contract. Do not edit this page manually.

nimbu channels

Manage channels and entries

nimbu channels copy

Copy channel configuration between sites

Flags

FlagRequiredDefaultDescription
--allnoCopy all channels from source to target
--fromyesSource site/channel or site when using --all
--toyesTarget site/channel or site when using --all
--from-hostnoSource API base URL or host
--to-hostnoTarget API base URL or host

nimbu channels create

Create a channel from JSON or inline assignments

Arguments

NameRequiredDescription
assignmentsnoInline assignments (e.g. name=Testimonials slug=testimonials title_field=author; customizations:=@fields.json)

Flags

FlagRequiredDefaultDescription
--filenoRead channel JSON from file (use - for stdin)

nimbu channels delete

Delete a channel (requires --force)

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug

nimbu channels diff

Diff channel configuration between sites

Flags

FlagRequiredDefaultDescription
--fromyesSource site/channel
--toyesTarget site/channel
--from-hostnoSource API base URL or host
--to-hostnoTarget API base URL or host

nimbu channels empty

Empty a channel after strict confirmation

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--confirmnoExact channel slug confirmation

nimbu channels entries

Manage channel entries

nimbu channels entries copy

Copy channel entries between sites

Flags

FlagRequiredDefaultDescription
--fromyesSource site/channel
--toyesTarget site/channel
--from-hostnoSource API base URL or host
--to-hostnoTarget API base URL or host
--recursivenoRecursively copy referenced channel entries
--onlynoComma-separated channel allowlist when using --recursive
--querynoRaw query string to append to the source entry list
--wherenoWhere expression for source entry selection
--per-pagenoItems per page
--upsertnoComma-separated upsert fields, optionally channel-scoped as channel:field
--copy-customersnoCopy related customers for owners and customer fields
--allow-errorsnoContinue on item-level validation errors
--dry-runnoReserved for parity; currently reports planned selection only

nimbu channels entries count

Count entries

Flags

FlagRequiredDefaultDescription
--localenoFilter by locale
--filtersnoFilter by key=value, repeatable
--channelyesChannel ID or slug

nimbu channels entries create

Create entry from JSON

Arguments

NameRequiredDescription
assignmentsnoInline assignments (e.g. title=Hello, fields.teaser=Text)

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--filenoRead entry JSON from file (use - for stdin)

nimbu channels entries delete

Delete entry

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug

Manage gallery fields on channel entries

Append gallery images

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug
--fieldyesGallery field name
--imagenoLocal image path (repeatable)
--captionnoCaption for each image, matched by order
--positionnoPosition for each image, matched by order
--localenoContent locale for localized channel fields
--dry-runnoPrint the payload without updating the entry

List gallery images

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug
--fieldyesGallery field name
--localenoContent locale for localized channel fields

Remove gallery images

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug
--fieldyesGallery field name
--image-idyesGallery image ID to remove (repeatable)
--localenoContent locale for localized channel fields
--dry-runnoPrint the payload without updating the entry

Reorder gallery images

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug
--fieldyesGallery field name
--orderyesComma-separated gallery image IDs in desired order
--localenoContent locale for localized channel fields
--dry-runnoPrint the payload without updating the entry

Replace gallery images

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug
--fieldyesGallery field name
--imagenoLocal image path (repeatable)
--captionnoCaption for each image, matched by order
--positionnoPosition for each image, matched by order
--localenoContent locale for localized channel fields
--dry-runnoPrint the payload without updating the entry

Update one gallery image

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug
--fieldyesGallery field name
--image-idyesGallery image ID
--captionnoUpdated caption
--positionnoUpdated position
--imagenoReplacement local image path
--localenoContent locale for localized channel fields
--dry-runnoPrint the payload without updating the entry

nimbu channels entries get

Get entry by ID or slug

Flags

FlagRequiredDefaultDescription
--fieldsnoComma-separated fields to return
--localenoFilter by locale
--includenoInclude related resources
--sortnoSort by field, e.g. field or field:desc
--filtersnoFilter by key=value, repeatable
--channelyesChannel ID or slug
--entryyesEntry ID or slug

nimbu channels entries list

List channel entries

Flags

FlagRequiredDefaultDescription
--fieldsnoComma-separated fields to return
--localenoFilter by locale
--includenoInclude related resources
--sortnoSort by field, e.g. field or field:desc
--filtersnoFilter by key=value, repeatable
--channelyesChannel ID or slug
--allnoFetch all pages
--pageno1Page number
--per-pageno25Items per page

nimbu channels entries update

Update entry

Arguments

NameRequiredDescription
assignmentsnoInline assignments (e.g. title=Hello, fields.teaser=Text)

Flags

FlagRequiredDefaultDescription
--channelyesChannel ID or slug
--entryyesEntry ID or slug
--localenoContent locale for localized channel fields
--filenoRead entry JSON from file (use - for stdin)

nimbu channels fields

Manage channel fields

nimbu channels fields add

Add a channel field

Arguments

NameRequiredDescription
assignmentsnoField attributes (e.g. type=string label=Title)

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug
--nameyesField name

nimbu channels fields apply

Apply channel fields from JSON

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug
--fileyesRead field JSON array from file (use - for stdin)

nimbu channels fields delete

Delete a channel field

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug
--fieldyesField ID or name

nimbu channels fields diff

Diff channel fields against JSON

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug
--fileyesRead field JSON array from file (use - for stdin)

nimbu channels fields list

List channel fields

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug

nimbu channels fields replace

Replace channel fields from JSON

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug
--fileyesRead field JSON array from file (use - for stdin)

nimbu channels fields update

Update a channel field

Arguments

NameRequiredDescription
assignmentsnoField attributes to update (e.g. label=Headline required:=true)

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug
--fieldyesField ID or name

nimbu channels get

Get channel details

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug

nimbu channels info

Show rich channel info and TypeScript output

Flags

FlagRequiredDefaultDescription
--channelyesChannel slug or site/channel
--typescriptnoRender a TypeScript interface instead of the rich summary

nimbu channels list

List channels

Flags

FlagRequiredDefaultDescription
--fieldsnoComma-separated fields to return
--localenoFilter by locale
--includenoInclude related resources
--sortnoSort by field, e.g. field or field:desc
--filtersnoFilter by key=value, repeatable
--allnoFetch all pages
--pageno1Page number
--per-pageno25Items per page
--with-entry-countnotrueFetch entry count for each channel
--no-entry-countnoSkip fetching entry count for each channel

On this page