curl --request POST \
  --url https://apiv3.usecorvex.com.br/api/v1/kits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Store-Id: <x-store-id>' \
  --data '
{
  "name": "Kit verão",
  "description": "Camiseta + brinde",
  "image": "https://cdn.example.com/kit-verao.png",
  "status": "ACTIVE",
  "allowQuantityChange": false,
  "customShipping": {
    "type": "FREE"
  },
  "items": [
    {
      "productId": "22222222-2222-4222-8222-222222222222",
      "quantity": 1,
      "priceType": "SKU"
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Store-Id': '<x-store-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Kit verão',
    description: 'Camiseta + brinde',
    image: 'https://cdn.example.com/kit-verao.png',
    status: 'ACTIVE',
    allowQuantityChange: false,
    customShipping: {type: 'FREE'},
    items: [
      {
        productId: '22222222-2222-4222-8222-222222222222',
        quantity: 1,
        priceType: 'SKU'
      }
    ]
  })
};

fetch('https://apiv3.usecorvex.com.br/api/v1/kits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.usecorvex.com.br/api/v1/kits"

payload = {
    "name": "Kit verão",
    "description": "Camiseta + brinde",
    "image": "https://cdn.example.com/kit-verao.png",
    "status": "ACTIVE",
    "allowQuantityChange": False,
    "customShipping": { "type": "FREE" },
    "items": [
        {
            "productId": "22222222-2222-4222-8222-222222222222",
            "quantity": 1,
            "priceType": "SKU"
        }
    ]
}
headers = {
    "X-Store-Id": "<x-store-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "kit": {
      "id": "55555555-5555-4555-8555-555555555555",
      "storeId": "11111111-1111-4111-8111-111111111111",
      "name": "Kit verão",
      "slug": "kit-verao",
      "description": "Camiseta + brinde",
      "image": "https://cdn.example.com/kit-verao.png",
      "status": "ACTIVE",
      "allowQuantityChange": false,
      "customShipping": {
        "type": "FREE",
        "amount": null
      },
      "items": [
        {
          "productId": "22222222-2222-4222-8222-222222222222",
          "quantity": 1,
          "priceType": "SKU",
          "customPrice": null
        }
      ],
      "createdAt": "2026-09-24T14:00:00.000Z",
      "updatedAt": "2026-09-24T14:00:00.000Z"
    }
  }
}

{
  "success": false,
  "error": {
    "message": "Kit deve ter pelo menos um item",
    "code": "VALIDATION_ERROR"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 400
  }
}

{
  "success": false,
  "error": {
    "message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
    "code": "AUTH_API_KEY_REQUIRED"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 401
  }
}

{
  "success": false,
  "error": {
    "message": "Sua API Key não tem o escopo necessário para esta operação.",
    "code": "AUTH_SCOPE_DENIED"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 403
  }
}

{
  "success": false,
  "error": {
    "message": "Produto não encontrado",
    "code": "RESOURCE_NOT_FOUND"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 404
  }
}

{
  "success": false,
  "message": "Muitas requisições. Tente novamente em instantes.",
  "error": "RATE_LIMITED",
  "retryAfter": 12
}