Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

API Key no formato cvx_live_..., criada no painel Corvex. Não use JWT de sessão nem x-api-key.

Headers

X-Store-Id
string<uuid>
required

UUID da loja. A chave precisa ter esta loja autorizada.

Idempotency-Key
string

Chave de idempotência (1–128 caracteres). Replay em 24h devolve o mesmo produto.

Pattern: ^[A-Za-z0-9._-]{1,128}$

Body

application/json
name
string
required
Required string length: 3 - 100
type
enum<string>
required
Available options:
PHYSICAL,
DIGITAL
price
number
required
Required range: 0.01 <= x <= 999999.99
discountedPrice
number | null

Preço promocional. Sempre menor que price. Use null se não houver desconto.

Required range: x >= 0
media
object

Mídia do produto. A primeira URL de images vira a imagem principal.

description
string
shortDescription
string
status
enum<string>
Available options:
DRAFT,
ACTIVE,
PUBLISHED,
INACTIVE
stock
object
logistics
object
sku
string | null
Maximum string length: 100
barcode
string | null
Maximum string length: 100
costPrice
number | null
Required range: 0 <= x <= 999999.99
seo
object

Response

Produto criado.

success
boolean
Example:

true

data
object