​

🔁 Rotation Rules

​

Key Concepts

​

Supported Intervals

📅 Start Date Matters: Nota uses the start date as the anchor point when calculating which value should be active at runtime.

​

Create or Edit a Rule

1. Go to Settings → Rotation Rules.
2. Click ➕ Add Rule or select an existing rule to adjust.
3. Enter the Key, list of Values, Start Date, and Interval.
4. Save—Nota immediately begins serving the correct value based on the schedule.

​

Bulk Upload via JSON

[
  {
    "key": "API_KEY",
    "values": ["sk_test_key_1", "sk_test_key_2", "sk_test_key_3"]
  },
  {
    "key": "EMAIL_ACCOUNT",
    "values": ["qa+user1@example.com", "qa+user2@example.com"]
  }
]

​

Real-World Example

​

Best Practices

• Pair with Environment Variables: Store the rotation key once, then consume it via environment variables in workflows.
• Test ahead of time: Use a closer start date in staging to validate behavior before mirroring in production.
• Document ownership: Note who maintains each rule so rotations stay coordinated with downstream systems.