Skip to content

Category name in use

HTTP 409category_name_taken

When the API answers 409 category_name_taken, and how to fix it.

Version v1.1, updated

The type field of every category_name_taken response links to this page.

On this page

A category for the same kind of product already has this name. Two categories can share a name only when they are for different kinds.

At a glance

  • Status: 409 Conflict

  • Code: category_name_taken

  • Retry: No. Fix the cause first: the same request gets the same answer.

Causes and fixes

Likely cause

How to fix it

The category exists already.

List the categories, find it by name, and use its id.

Two categories of your system have the same name.

Give them distinct names in BIRP, or map both to one category.

Example

409 category_name_takenJSON
{
  "code": "category_name_taken",
  "detail": "A category of the same kind already has this name.",
  "errors": [
    {
      "field": "name",
      "message": "is used by another category of the same kind"
    }
  ],
  "instance": "/v1/categories",
  "request_id": "a1b2c3d4-0000-4000-8000-0000000000ee",
  "status": 409,
  "title": "Category name in use",
  "type": "https://birp.io/developers/errors/category_name_taken"
}

Related

  • categories
  • sync-products
  • references-and-external-ids