smartsuite-patterns

What problem does it solve?

Incorrect SmartSuite API usage, especially with choices vs. options, can lead to irreversible UUID corruption and data loss, while inconsistent field formats cause validation errors, jeopardizing data integrity.

Core Features & Use Cases

• UUID Corruption Prevention: Enforces the critical rule of using choices (with existing UUIDs) and never options to prevent permanent data destruction in select fields.
• Critical Field Format Rules: Provides strict guidelines for linked records (must be arrays), select/status fields (use option codes), and formula/rollup fields (read-only), ensuring correct data manipulation.
• Dry-Run Safety Pattern: Mandates using dryRun: true for all create/update operations to verify output before irreversible changes, protecting against accidental data modification.
• Use Case: When updating a SmartSuite field with new options, use this skill to ensure you correctly use choices with existing UUIDs and perform a dryRun first to prevent data corruption, saving critical data.

Quick Start

Update a SmartSuite field, ensuring you use choices instead of options to preserve existing UUIDs.