Create a category

POST 
/api/v2/catalog/categories

Create a new category for a business

Request

application/json

Body

required

name stringrequired

Possible values: non-empty

Name of the product category

order integer

Default value: 0

Used to order the item, order defaults to ascending.

business_id uuidrequired

Create category for given business

Responses

201

application/json

Schema

Schema

id stringrequired

Possible values: >= 12 characters and <= 12 characters, Value must match regular expression ^[0-9a-z]+$

Unique ID of the product category

name stringrequired

Possible values: non-empty

Name of the product category

slug stringrequired

Possible values: non-empty

Slug of the product category

order integerrequired

Default value: 0

Used to order the item, order defaults to ascending.

created_at date-timerequired
updated_at date-timerequired

Example (from schema)

{
  "id": "5m4v972ra9ue",
  "name": "Pizza",
  "slug": "pizza",
  "order": 1,
  "created_at": "2024-08-13T11:41:41.272Z",
  "updated_at": "2024-08-13T11:41:41.272Z"
}

400

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

401

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

403

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

404

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

422

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

errors

object[]

required

Array [

path stringrequired

Possible values: non-empty

Path to the property with the error

errors

object[]

required

Array [

type stringrequired

Possible values: non-empty

Error type

message stringrequired

Error message

]

]

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "errors": [
    {
      "path": "business.id",
      "errors": [
        {
          "type": "object_required_property",
          "message": "Required property"
        }
      ]
    }
  ]
}

500

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

Loading...