> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalog entities and relationships

> Manage all 17 public catalog resources: products, categories, attributes, families, vocabularies, prompts, knowledge and templates.

Use the Public API to build and maintain your catalog from your own systems. Every resource below supports listing, reading one record, creating, updating and deleting within the project bound to your API key.

## Available entities

Paths below are relative to `https://wisepim.com/api/public/v1`.

| Resource | What you manage |
| - | - |
| [Products](https://docs.wisepim.com/en/api-reference/products/list.md) | Product content, identifiers, prices, attributes and category links; batch upsert by SKU |
| [Categories](https://docs.wisepim.com/en/api-reference/categories/list.md) | Category trees, localized content, SEO, ordering and FAQs |
| [Attributes](https://docs.wisepim.com/en/api-reference/attributes/list.md) | Definitions, localized labels, options, validation and vocabulary links |
| [Attribute groups](https://docs.wisepim.com/en/api-reference/attribute-groups/list.md) | Names, localized names, codes and ordering |
| [Product families](https://docs.wisepim.com/en/api-reference/product-families/list.md) | Family identity, descriptions and hierarchy |
| [Family attributes](https://docs.wisepim.com/en/api-reference/family-attributes/list.md) | Attribute bindings, requirements, variant axes, defaults and vocabulary overrides |
| [Product categories](https://docs.wisepim.com/en/api-reference/product-categories/list.md) | Category memberships and primary-category flags |
| [Value code sets](https://docs.wisepim.com/en/api-reference/value-code-sets/list.md) | Controlled vocabularies and new-value policy |
| [Code set values](https://docs.wisepim.com/en/api-reference/code-set-values/list.md) | Individual localized vocabulary options |
| [Unit-of-measure sets](https://docs.wisepim.com/en/api-reference/uom-code-sets/list.md) | Unit sets and their category |
| [Units of measure](https://docs.wisepim.com/en/api-reference/uom-values/list.md) | Units, symbols, localized names and conversion factors |
| [Prompts](https://docs.wisepim.com/en/api-reference/prompts/list.md) | Saved prompt text and configuration visible to the key's issuer |
| [Knowledge libraries](https://docs.wisepim.com/en/api-reference/knowledge-libraries/list.md) | Structured brand knowledge, with one library per project |
| [Dictionary entries](https://docs.wisepim.com/en/api-reference/dictionary-entries/list.md) | Terms, translation overrides, context and category links |
| [Keywords](https://docs.wisepim.com/en/api-reference/keywords/list.md) | Terms, intent, locale, target fields, priority and category links |
| [Import templates](https://docs.wisepim.com/en/api-reference/import-templates/list.md) | Saved mappings, transformations and duplicate/value handling |
| [Export templates](https://docs.wisepim.com/en/api-reference/export-templates/list.md) | Output configuration, column mappings, locales and family links |

## Common operations

For a resource such as `keywords`, use:

| Method and path | Required scope | Success |
| - | - | - |
| `GET /keywords` | `keywords:read` | `200`, paginated `data` |
| `GET /keywords/{resource_id}` | `keywords:read` | `200`, one record |
| `POST /keywords` | `keywords:write` | `201`, created record |
| `PATCH /keywords/{resource_id}` | `keywords:write` | `200`, updated record |
| `DELETE /keywords/{resource_id}` | `keywords:delete` | `204`, no body |

Use the matching resource prefix for other scopes. Deletion is a separate permission: `products:write` does not grant `products:delete`. See the [scope catalog](https://docs.wisepim.com/en/api-reference/authentication.md#scopes) and each endpoint for its exact path parameters and payload.

Lists use `cursor` and `limit` with a maximum of 200 rows. Many support `ids`; product lists also support SKUs and incremental sync. Follow the filters declared on the individual endpoint.

Send an `Idempotency-Key` on mutations and reuse it only for retries of that exact request. See [retry rules](https://docs.wisepim.com/en/api-reference/introduction.md#retries-and-idempotency).

## Update only what you intend

`PATCH` changes only supplied fields. Omitting a field and sending `null` have different meanings; check the schema for fields that accept null. Unknown fields and changes to record identity, project or ownership are rejected.

Related records must belong to the key's project. An unavailable detail ID returns `404`; an invalid relationship rejects the mutation. Category and family tree moves cannot create cycles. For code set values and units, `code_set` is required on creation and cannot be changed afterwards.

Category and attribute reads retain their compact response shapes. Use [category configuration](https://docs.wisepim.com/en/api-reference/categories/configuration.md) or [attribute configuration](https://docs.wisepim.com/en/api-reference/attributes/configuration.md) for the full configuration represented by their writable fields.

## Permissions and resource-specific rules

* **Prompts:** reads follow the issuer's visibility; only the owner can update or delete a prompt. Publishing a prompt publicly is not exposed through these writes.
* **Knowledge:** each project has one knowledge library. Creating a second returns `409`; reading never creates one.
* **Templates:** these endpoints manage saved configuration. They do not launch imports or exports. Manage export-template attribute selections in the template editor.
* **Relationships:** use family attributes and product categories to manage bindings explicitly. Their IDs identify the binding record, not the product, family, attribute or category itself.
* **Role permissions:** scopes supplement the issuer's current permissions. Resource management, product deletion and category membership retain their corresponding role or field permissions.

For work that processes a selection of products, use [actions and jobs](https://docs.wisepim.com/en/api-reference/actions-and-jobs.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.