Skip to main content
POST
/
v1
/
products
Create a product
curl --request POST \
  --url https://api.kyren.top/v1/products \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "1000 AI Credits",
  "description": "Top up 1000 credits for AI API usage",
  "price": "9.99",
  "currency": "USD",
  "metadata": {
    "credits": "1000"
  }
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "id": "prod_abc123",
    "name": "1000 AI Credits",
    "description": "Top up 1000 credits for AI API usage",
    "image": null,
    "price": "9.99",
    "currency": "USD",
    "status": "ACTIVE",
    "metadata": {
      "credits": "1000"
    },
    "createdAt": 1736932200000,
    "updatedAt": 1736932200000
  }
}

Authorizations

​
x-api-key
string
header
required

Your API key. Public production API-key endpoints accept kyren_live_* keys. Staging credentials are environment-specific and must be used only with the staging environment for which Kyren issued them.

Body

application/json
​
name
string
required

The name of the product

Maximum string length: 200
​
price
string
required

The price of the product (e.g. "9.99"), must be at least 0.01

Pattern: ^\d+(\.\d{1,2})?$
​
description
string

A description of the product

Maximum string length: 1000
​
image
string

URL of the product image

​
currency
string
default:USD

Three-letter ISO currency code (e.g. USD, CNY, HKD)

​
metadata
object

Arbitrary key-value pairs for your own use

Response

Product created successfully

​
code
integer
Example:

0

​
message
string
Example:

"success"

​
data
object