Build on the same catalog the platform runs on.
REST APIs at https://api.catazenta.com — organized by commerce capability, not internal service names. The UI, syndication workers, specialist agents, and MCP all use this surface.
JSON bodies, JWT authentication, tenant-scoped catalog operations, and OpenAPI specs for every area — copy patterns into Postman or your integration today.
How the APIs fit together
Every integration reads and writes the same governed catalog — not a shadow API layer.
| Convention | Detail |
|---|---|
| Base URL | https://api.catazenta.com |
| Format | JSON request and response bodies |
| Auth | Authorization: Bearer <access_token> — see Authentication |
| Tenant | Scope from JWT claims or X-Tenant-Id where applicable |
| Lists | Paginated (page, page_size) — Pagination & errors |
| Contracts | OpenAPI + Redoc on this site — OpenAPI & Postman |
Specialist agents propose writes through the approval queue; MCP tools call the same REST paths. Your integrations participate in the same audit trail and channel rules.
Products
Create and govern the catalog your AI and channels consume.
| Task | Start here |
|---|---|
| Create / update products | Product API · Recipe: create product |
| Variants & attributes | Product API · Update attributes |
| Categories & taxonomy | Category API · Attribute API |
| Completeness & gaps | Product intelligence · Completeness recipe |
| Search & dashboard | Search API |
Product API
Products, variants, families, attribute values, completeness.
Category API
Category trees, nodes, product assignments.
Attribute API
Attribute definitions, groups, options, UoM.
Assets
| Task | Start here |
|---|---|
| Upload & manage media | DAM API |
| Link assets to SKUs | Recipe: link DAM |
| Renditions & folders | DAM guide |
Workflows
| Task | Start here |
|---|---|
| Approvals & tasks | Workflows guide |
| Users, roles, permissions | IAM API |
| Service accounts | Service account recipe |
Human gates in PIM workflows complement Agent Control Center approvals for agent-proposed writes.
Syndication
| Task | Start here |
|---|---|
| Connections & export profiles | Integration API |
| Export / import jobs | Job API |
| Poll async job status | Poll export job |
| Amazon | Amazon syndication · Connector |
| Shopify | Shopify syndication |
MCP equivalent: list_connections, quick_publish, create_export_job — see MCP tools.
API reference index
Interactive Redoc pages generated from OpenAPI — one reference per backend area.
| API | Description |
|---|---|
| Product | Products, models, families, completeness |
| Category | Category trees and assignments |
| Attribute | Attribute definitions and options |
| DAM | Assets, folders, renditions |
| IAM | Auth, users, roles, tenants |
| Integration | Connectors, connections, export/import |
| Job | Async import/export jobs and schedules |
| Search | Dashboard and search endpoints |
Download raw OpenAPI JSON → OpenAPI & Postman · Postman collection
Recipes — task-focused guides
Copy-paste examples against https://api.catazenta.com — faster than browsing every endpoint.
Getting started
All recipes → Recipes index
REST vs MCP vs in-product agents
| REST APIs | MCP | Specialist agents (ACC) | |
|---|---|---|---|
| Best for | ERP, custom pipelines, headless | Claude, ChatGPT, Cursor | Scheduled runs, approvals, insights |
| Auth | JWT / service account | OAuth or connector token | PIM session (ai_mgmt) |
| Writes | Direct API calls (RBAC) | Named tool calls | Approval queue → apply |
→ MCP overview · Agentic PIM · API overview
Developer essentials
| Topic | Doc |
|---|---|
| Authentication | Authentication |
| Pagination & errors | Pagination & errors |
| Versioning | API versioning |
| Webhooks | Webhooks |
| OpenAPI downloads | OpenAPI & Postman |
| Changelog | Changelog |
| Architecture | API-first platform |
Get started
- Complete Your first API call — login, list products, verify identity.
- Read Authentication — user JWT vs service accounts.
- Pick a capability above (products, DAM, syndication, …).
- Use Recipes for copy-paste task flows.
- Wire MCP when conversational or IDE automation fits better than raw REST.
Need access? Contact CataZenta for tenant credentials.
GO DEEPER