contentrain-bulk

Skill: Run Bulk Content Operations

Apply safe batch operations to existing content entries.

---

When to Use

Use this when the user wants to:

• copy one locale to another
• update status on many entries
• delete multiple collection entries

This skill is for existing content, not for schema design.

---

Steps

1. Inspect the Model

Call contentrain_status and contentrain_describe(model: "<model-id>") first.

Confirm:

• model kind
• whether i18n is enabled
• which locales are supported

2. Pick the Correct Bulk Operation

• copy_locale: clone one locale to another for i18n-enabled collection, singleton, or dictionary models
• update_status: update metadata state — many entries at once for collection, or the single record of a singleton/dictionary
• delete_entries: remove many collection entries at once

3. Apply Safety Rules

• never use copy_locale on non-i18n models
• update_status takes entry_ids for collection models and rejects them for singleton/dictionary — those have one meta record per locale, so omit entry_ids entirely. Document models are not supported (their meta is keyed by slug).
• delete_entries is collection-only
• update_status rewrites every supported locale unless you pass locale. Pass it when restoring one locale's status, or you will change the other's too.
• confirm entry IDs before delete operations
• batch only related entries together

4. Execute with contentrain_bulk

Examples:

{
  "operation": "copy_locale",
  "model": "ui-labels",
  "source_locale": "en",
  "target_locale": "tr"
}

{
  "operation": "update_status",
  "model": "blog-post",
  "entry_ids": ["post_001", "post_002"],
  "status": "in_review"
}

Scoped to one locale — leaves every other locale's status untouched:

{
  "operation": "update_status",
  "model": "blog-post",
  "entry_ids": ["post_001"],
  "status": "published",
  "locale": "tr"
}

A singleton or dictionary — one meta record, so no entry_ids: