---
title: "Create a variant knowledge item"
method: POST
path: "/v3/variants/{variant_id}/knowledge-items"
tags: ["Business Products"]
---

# Create a variant knowledge item

`POST /v3/variants/{variant_id}/knowledge-items`

Requires the `product:update` scope. Creates a new variant-level knowledge item.

## Request body

- CreateUpdateProductKnowledgeItemRequest
  - `a` string, required — Answer text (max 3000 chars)
  - `position` integer — Display position (0-indexed)
  - `q` string, required — Question text (max 255 chars)

## Response `200`

Created knowledge item

- ProductKnowledgeItem
  - `a` string — Answer text (max 3000 chars)
  - `id` string, uuid — Knowledge item ID (UUIDv7)
  - `inserted_at` string, date-time — Creation timestamp
  - `position` integer — Display position (0-indexed)
  - `product_id` integer — Product ID
  - `q` string — Question text (max 255 chars)
  - `updated_at` string, date-time — Last update timestamp
  - `variant_id` integer, nullable — Variant ID (null for product-level items)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/versions/4354959d76dc/schema)