engineer-platform-api

Implement Braze REST API endpoints for authentication, SCIM, user merges, and templates.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-platform-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineer-platform-api
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/engineer-platform-api
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-platform-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides clear, operational guidance for implementing and troubleshooting Braze platform-level REST APIs so backend engineers can avoid data loss, permission errors, and inconsistent state when managing identity, content, and media surfaces.

Core Features & Use Cases

  • Implements patterns and constraints for SDK authentication, SCIM provisioning, user merge semantics, template and translation management, media library uploads, and preference center updates.
  • Explains async behaviors, permission scoping, idempotency, multipart binary handling, Liquid template validation, and recommended error and rate-limit handling.
  • Use Case: An engineer building a service to issue SDK session tokens, provision dashboard users via SCIM, and reliably merge user profiles while preserving auditability and avoiding partial failures.

Quick Start

Use the engineer-platform-api skill to audit and implement platform endpoints for SDK auth, SCIM, user merges, templates, translations, media uploads, and preference center updates.

Frequently Asked Questions about engineer-platform-api

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

FAQPage Schema
How do I implement Braze platform API endpoints for SDK authentication and SCIM provisioning?

Implement Braze platform API endpoints by applying patterns for SDK session token issuance and SCIM user provisioning. This skill provides operational guidance for strict permission scoping and asynchronous job handling across these infrastructure surfaces.

What is the best way to handle Braze user merge workflows without partial failures?

The best way to handle Braze user merge workflows is using POST /users/merge endpoints with idempotency and ordering guarantees. This preserves auditability and prevents data loss or inconsistent state during profile merges.

How does multipart media upload work with Braze platform APIs?

Multipart media upload works by handling multipart/form-data binary payloads through Braze media library endpoints. This skill guides multipart binary handling, structured error-body inspection, and rate-limit backoff strategies for reliable uploads.

How do I validate Liquid templates when managing Braze preference center updates?

Validate Liquid templates during PUT preference_center updates by applying strict template validation rules. This ensures correct rendering and prevents configuration errors within Braze preference center surfaces.

Why are my Braze template management PUT requests failing due to rate limits?

Braze template management PUT requests fail when exceeding API rate limits. Resolve this by implementing recommended rate-limit backoff strategies and structured error-body inspection to handle asynchronous job constraints and retry safely.

Can I use this approach to manage both Braze template translations and dashboard user identity?

Yes, this approach manages Braze template translations and dashboard user identity together. It covers SCIM provisioning for dashboard users alongside PUT/POST template and translation management workflows.