skills.rest
delta-and-beta
delta-and-betaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

engineer-catalog-api

Implement Braze catalog CRUD operations across synchronous and asynchronous endpoints.

Updated Apr 6, 2026
Search Tags:#api#crud#upsert#catalogs#selections#braze#sync-async
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-catalog-api
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: engineer-catalog-api
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/engineer-catalog-api
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-catalog-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enables engineers to implement and operate Braze catalog CRUD workflows across synchronous and asynchronous endpoints, reducing silent failures, rate-limit errors, and inconsistent data states when working with items, fields, selections, and catalog lifecycle management.

Core Features & Use Cases

  • Sync vs Async Guidance: Clear rules for choosing synchronous endpoints for real-time single-item operations and asynchronous endpoints for bulk operations and selections, plus polling/webhook patterns.
  • Resource Management: Patterns for creating, listing, updating (upsert semantics), and deleting catalogs, fields, items, and selections with permission and rate-limit considerations.
  • Selections & Personalization: How to design, create, preview, and use named selections as filtered views for message personalization, including limits and Liquid considerations.
  • Troubleshooting & Error Handling: Mapped error IDs to remediation steps, common mistakes, and validation rules to avoid invalid requests and permission issues.

Quick Start

Create a catalog selection named favorite-restaurants for catalog restaurants with filters City equals NYC and Rating greater than 7, set results_limit to 10, and return the recommended API request, required permission, and follow-up polling strategy.

Frequently Asked Questions about engineer-catalog-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between sync and async Braze catalog endpoints for CRUD operations?▼

Use synchronous Braze catalog endpoints for real-time single-item operations, and switch to asynchronous endpoints for bulk item processing or managing selections to avoid silent failures and rate-limit errors.

What's the best way to handle bulk catalog item updates in Braze without hitting rate limits?▼

For bulk catalog item updates, use asynchronous Braze endpoints with upsert semantics, then handle job completion through polling or webhook patterns while respecting both sync and async rate limits.

How do I create and use Braze catalog selections for message personalization?▼

Create named Braze catalog selections as filtered views by defining field filters and result limits, then reference them in Liquid for message personalization while respecting selection preview limits.

Why do my Braze catalog API requests fail with permission or validation errors?▼

Braze catalog API requests fail when they lack required permission scopes or violate validation rules; map returned error IDs to specific remediation steps to fix invalid requests and permission issues.

Can I replace existing catalog items using upsert semantics in Braze?▼

Yes, Braze catalog CRUD operations support upsert semantics, allowing you to replace existing catalog items during single-item real-time updates or bulk background jobs.

What polling strategy should I use for asynchronous Braze catalog jobs?▼

For asynchronous Braze catalog jobs, implement a polling strategy that checks job completion status at intervals, or configure webhooks to notify completion while respecting async rate limits.

Related Skills

Explore More Software Engineering Skills→
MaosixianMaosixian

shopify

Execute CRUD operations on Shopify products, orders, and inventory.

Community
Intermediate
delta-and-betadelta-and-beta

strategist-recommendations

Design and deploy personalized item recommendation strategies for Braze campaigns and Canvases.

Community
Advanced
delta-and-betadelta-and-beta

engineer-webhooks

Design and validate HTTP webhook requests for Braze integrations.

Community
Intermediate
delta-and-betadelta-and-beta

engineer-cloud-ingestion

Configure cloud data ingestion connectors and transformation pipelines for Braze.

Community
Advanced