Crystallize Mutation Skill

Create, update, and manage data in Crystallize using GraphQL mutations. This skill covers all write operations across the Core API (admin/content management) and Shop API (cart/checkout).

Consultation Approach

Before writing mutations, understand the context. Ask clarifying questions:

1. What are you trying to create or update? Products, documents, folders, customers, orders?
2. Do you have the tenant identifier and access tokens? Mutations require authentication.
3. Where in the flow are you? Content/catalog management → Core API. Cart/checkout/orders → Shop API.
4. Do you need to update individual fields or create items from scratch? updateComponent for fields, create for new items.
5. Should changes be published immediately? Creating an item doesn't publish it — that's a separate step.
6. Are you doing a one-off change or a bulk import? Single mutations vs mass operations.

Decision Tree

What do you need to do?