Create Persistent Categorization

Use this request to start a persistent categorization job. In the request, include each product's:

• Unique ID
• Title
• Description
• (Optional) Additional columns

After you submit a POST request to /categorize/persist, a new persistent categorization job is created. The response includes a job ID which you can use to retrieve the results.

📘

Note: Job results are persisted

The results of a persistent categorization job are stored in the Smart Categorization application. If you don't want the results to be stored in the application, use the POST /categorize endpoint.

Sample request - Create persistent categorization

{
  "products": [
    {
      "productUniqueId": "009300002875-test",
      "productTitle": "Bread & Butter Sliders",
      "productDescription": "Mt Olive Old-Fashioned Sweet Bread & Butter Sliders 24 fl oz",
      "concatenatedExtraColumns": {}
    }
  ]
}

Sample request - Create persistent categorization

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "clientVertexId": "3fa85f64-5717-4562-b3fc-2c963f66afa60",
  "startTime": "2025-04-05T00:32:09.6587169Z",
  "endTime": null,
  "persistent": true,
  "numProducts": 1,
  "numIssues": 0,
  "blobUri": null,
  "retentionDays": 30,
  "result": null
}