Skip to main content
POST
/
ai
/
inventory
/
category
Generate Category
curl --request POST \
  --url https://api.decodahealth.com/ai/inventory/category \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "name": "<string>",
  "itemType": "ITEM",
  "modelName": "gemini-2.0-flash",
  "useStructuredOutput": false,
  "previousGeneration": "<string>",
  "feedback": "<string>",
  "existingCategories": [
    "<string>"
  ],
  "brandName": "<string>",
  "currentDescription": "<string>"
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Headers

​
TENANT
string
required

The tenant you are making this request on behalf of

​
API-KEY
string
required

Your api key

Body

application/json

Request schema for suggesting categories.

​
name
string
required

Name of the item

​
itemType
enum<string>
required

Type of item

Available options:
ITEM,
PRODUCT,
MEDICATION,
SERVICE,
PACKAGE,
MEMBERSHIP
​
modelName
string
default:gemini-2.0-flash

Model to use for generation

​
useStructuredOutput
boolean
default:false

Whether to request structured JSON output

​
previousGeneration
string | null

Previous generated text for context

​
feedback
string | null

User feedback for regeneration

​
existingCategories
string[]

List of existing category names

​
brandName
string | null

Optional brand name

​
currentDescription
string | null

Current description

Response

Successful Response