Custom Governance Rules

Treblle’s Custom Governance Rules feature allows you to bring your organization’s security and quality playbooks directly into the platform using Spectral rule sets.

Custom Governance Rules enable you to:

• Upload Custom Rule Sets: Import Spectral-built rules at the workspace level
• Apply Rules Per API: Assign different rule sets to different APIs based on team needs or standards
• Maintain Consistency: API governance pages remain unchanged, with your custom rules integrated seamlessly

There are two ways to access the Governance Rules settings:

1. Open Workspace Settings

   Click on Settings in the left navigation bar at the workspace level.

2. Select Governance Rules

   Navigate to the Governance Rules section under the Settings menu.

   

1. Navigate to API Governance

   Go to any API dashboard and click on Governance in the left navigation.

2. Click Settings

   Click the Settings button in the top-right corner of the Governance page.

   

This will take you directly to the Governance Rules configuration page.

1. Click New Ruleset

   Click the + New Ruleset button in the top-right corner of the Governance Rules page.

   

2. Upload Dialog Opens

   A dialog titled “Upload Spectral Ruleset” will appear with the following information:

   • Instructions: “When you upload a ruleset, you will need to assign it to one or more APIs. Only one ruleset can be applied per API.”
   • Upload area: Drag and drop or click to select a file
   • File format: “.yaml and .json files only”

3. Select Your File

   • Click the upload area or drag and drop your Spectral ruleset file
   • Supported formats: YAML (.yaml) and JSON (.json)

4. Upload the Ruleset

   Click the Upload button to add the ruleset to your workspace.

The Governance Rules page displays all uploaded rule sets in a table format:

Column	Description
Name	Ruleset identifier (e.g., treblle-default.yaml, custom-file1.yaml)
Date Uploaded	When the ruleset was added to Treblle
Applies To	Scope of application (Workspace or specific APIs)
Enabled	Toggle to activate or deactivate the ruleset

Important guidelines for applying rule sets:

• One Ruleset Per API: Only one ruleset can be applied per API at a time
• Multiple API Assignment: A single ruleset can be assigned to multiple APIs
• Workspace-Level Management: All rulesets are managed at the workspace level

Each ruleset has an actions menu (three dots) with the following options:

• Open File: View the Spectral ruleset contents
• Apply To: Modify which APIs use this ruleset
• Replace: Upload a new version of the ruleset
• Delete: Remove the ruleset from your workspace

Custom Spectral rules integrate with Treblle’s governance framework:

1. Upload Once: Add your Spectral ruleset at the workspace level
2. Apply Flexibly: Choose which APIs should follow which rule sets
3. Automatic Evaluation: APIs are automatically scored against your custom rules
4. Unified Reporting: Custom rules appear on the API Governance page alongside standard categories

When applying rule sets to APIs:

• Each API can have only one custom ruleset applied at a time
• Custom rules replace Treblle’s default governance checks when applied
• Treblle’s default rules are used when no custom ruleset is assigned
• Default rules cannot be deleted and remain available as the baseline
• You can switch between custom and default rules at any time

Spectral rule sets must be:

• Valid Format: Properly formatted YAML (.yaml) or JSON (.json) files
• OpenAPI Compatible: Rules designed for OpenAPI specifications
• Self-Contained: Include all necessary rule definitions

• .yaml files: YAML-formatted Spectral rulesets
• .json files: JSON-formatted Spectral rulesets

Custom Governance Rules with Spectral integration enable you to enforce your organization’s specific standards while leveraging Treblle’s comprehensive API governance framework. This ensures consistency, compliance, and quality across your entire API estate.