Adding Sources

Sources define where your catalog’s operations come from. Filters control which operations are included. Together, they let you compose exactly the catalog you need.

What Are Sources?

A source is something your catalog pulls operations from:

• APIs — Public APIs like GitHub, Stripe, or your uploaded specs
• Catalogs — Other catalogs, enabling composition

Each source can include all operations or just a filtered subset.

Adding a Source

1. Navigate to your catalog
2. Go to Sources
3. Click Add Source
4. Search for an API or catalog
5. Configure filters (optional)
6. Save

The source’s operations become part of your catalog.

Filter Types

Filters narrow which operations a source contributes. All filters are optional.

Operation Pattern

Match operation IDs with glob patterns:

Endpoint Pattern

Match HTTP method and path:

Tag Pattern

Match OpenAPI tags:

API Name

When sourcing from a catalog that includes multiple APIs, filter by API name:

How Filters Combine

Within a Source: AND

Multiple filters on the same source combine with AND:

Source: GitHub
  Filters:
    - Operation pattern: issues.*
    - Endpoint pattern: POST /*

  Result: Operations matching issues.* AND POST
          → issues.create (but not issues.list which is GET)

Across Sources: OR

Multiple sources combine with OR:

Source 1: GitHub
  Filter: tag = issues

Source 2: Stripe
  Filter: tag = customers

Result: GitHub issue operations OR Stripe customer operations
        → All matching operations from both sources

Composition Patterns

Include Everything from an API

Add a source with no filters:

Source: GitHub API
Filters: (none)
Result: All GitHub operations (thousands)

Include a Focused Subset

Add filters to narrow scope:

Source: GitHub API
Filters:
  - Tag: issues
  - Endpoint: POST /*
Result: Only GitHub operations for creating/updating issues

Combine Multiple APIs

Add multiple sources:

Source 1: Stripe API
  Filter: Tag = customers
Source 2: HubSpot API
  Filter: Tag = contacts

Result: Stripe customers + HubSpot contacts

Include from Another Catalog

Source a catalog to inherit its composition:

Source: company/core-apis (catalog)
Filters: (none)

Result: Everything in the core-apis catalog

Then add additional sources for this catalog’s unique operations.

Layer Filtering

Source a broad catalog, then filter:

Source: company/all-apis (catalog)
Filters:
  - Tag: read-only

Result: Only read operations from all-apis

Previewing Operations

Before saving a source, preview what operations will be included:

1. Configure your source and filters
2. Click Preview
3. See the list of matching operations
4. Adjust filters if needed
5. Save when satisfied

Managing Sources

Editing a Source

1. Go to Sources in your catalog
2. Click the source you want to edit
3. Modify filters
4. Save

Changes take effect after the catalog reindexes.

Removing a Source

1. Go to Sources
2. Click the menu on the source
3. Select Remove
4. Confirm

Operations from that source are removed from your catalog.

Source Order

Sources are processed in order, but order doesn’t affect the final result—all matching operations are included regardless of source order.

Examples

DevOps Catalog

Source 1: GitHub API
  Filters: Tags = repos, pulls, issues

Source 2: AWS API
  Filters: Tags = ec2, s3, lambda

Source 3: Cloudflare API
  Filters: (none - include all)

Read-Only Catalog

Source 1: company/full-catalog
  Filters: Endpoint = GET /*

Customer-Facing Catalog

Source 1: company/internal-apis
  Filters:
    - Tag = public-api
    - Operation = *.list, *.get

Next Steps

• Uploading APIs — Add your own OpenAPI specs
• Overrides — Customize operation behavior
• Variables — Dynamic catalog configuration