Update Product

curl --request PUT \
  --url https://api.example.com/api/products/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "nombre": "<string>",
  "descripcion": "<string>",
  "precio": 123,
  "precioOriginal": 123,
  "stock": 123,
  "categoriaId": 123,
  "marcaId": 123,
  "peso": 123,
  "alto": 123,
  "ancho": 123,
  "profundidad": 123,
  "isFeatured": true
}
'

import requests

url = "https://api.example.com/api/products/:id"

payload = {
    "nombre": "<string>",
    "descripcion": "<string>",
    "precio": 123,
    "precioOriginal": 123,
    "stock": 123,
    "categoriaId": 123,
    "marcaId": 123,
    "peso": 123,
    "alto": 123,
    "ancho": 123,
    "profundidad": 123,
    "isFeatured": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    nombre: '<string>',
    descripcion: '<string>',
    precio: 123,
    precioOriginal: 123,
    stock: 123,
    categoriaId: 123,
    marcaId: 123,
    peso: 123,
    alto: 123,
    ancho: 123,
    profundidad: 123,
    isFeatured: true
  })
};

fetch('https://api.example.com/api/products/:id', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/products/:id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'nombre' => '<string>',
    'descripcion' => '<string>',
    'precio' => 123,
    'precioOriginal' => 123,
    'stock' => 123,
    'categoriaId' => 123,
    'marcaId' => 123,
    'peso' => 123,
    'alto' => 123,
    'ancho' => 123,
    'profundidad' => 123,
    'isFeatured' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/products/:id"

	payload := strings.NewReader("{\n  \"nombre\": \"<string>\",\n  \"descripcion\": \"<string>\",\n  \"precio\": 123,\n  \"precioOriginal\": 123,\n  \"stock\": 123,\n  \"categoriaId\": 123,\n  \"marcaId\": 123,\n  \"peso\": 123,\n  \"alto\": 123,\n  \"ancho\": 123,\n  \"profundidad\": 123,\n  \"isFeatured\": true\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/api/products/:id")
  .header("Content-Type", "application/json")
  .body("{\n  \"nombre\": \"<string>\",\n  \"descripcion\": \"<string>\",\n  \"precio\": 123,\n  \"precioOriginal\": 123,\n  \"stock\": 123,\n  \"categoriaId\": 123,\n  \"marcaId\": 123,\n  \"peso\": 123,\n  \"alto\": 123,\n  \"ancho\": 123,\n  \"profundidad\": 123,\n  \"isFeatured\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/products/:id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"nombre\": \"<string>\",\n  \"descripcion\": \"<string>\",\n  \"precio\": 123,\n  \"precioOriginal\": 123,\n  \"stock\": 123,\n  \"categoriaId\": 123,\n  \"marcaId\": 123,\n  \"peso\": 123,\n  \"alto\": 123,\n  \"ancho\": 123,\n  \"profundidad\": 123,\n  \"isFeatured\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": 123,
    "nombre": "<string>",
    "descripcion": "<string>",
    "precio": 123,
    "precioOriginal": 123,
    "stock": 123,
    "foto": "<string>",
    "isFeatured": true,
    "peso": 123,
    "alto": 123,
    "ancho": 123,
    "profundidad": 123,
    "categoriaId": 123,
    "marcaId": 123,
    "createdAt": {},
    "updatedAt": {}
  }
}

PUT

api

products

:id

Update Product

curl --request PUT \
  --url https://api.example.com/api/products/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "nombre": "<string>",
  "descripcion": "<string>",
  "precio": 123,
  "precioOriginal": 123,
  "stock": 123,
  "categoriaId": 123,
  "marcaId": 123,
  "peso": 123,
  "alto": 123,
  "ancho": 123,
  "profundidad": 123,
  "isFeatured": true
}
'

import requests

url = "https://api.example.com/api/products/:id"

payload = {
    "nombre": "<string>",
    "descripcion": "<string>",
    "precio": 123,
    "precioOriginal": 123,
    "stock": 123,
    "categoriaId": 123,
    "marcaId": 123,
    "peso": 123,
    "alto": 123,
    "ancho": 123,
    "profundidad": 123,
    "isFeatured": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    nombre: '<string>',
    descripcion: '<string>',
    precio: 123,
    precioOriginal: 123,
    stock: 123,
    categoriaId: 123,
    marcaId: 123,
    peso: 123,
    alto: 123,
    ancho: 123,
    profundidad: 123,
    isFeatured: true
  })
};

fetch('https://api.example.com/api/products/:id', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/products/:id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'nombre' => '<string>',
    'descripcion' => '<string>',
    'precio' => 123,
    'precioOriginal' => 123,
    'stock' => 123,
    'categoriaId' => 123,
    'marcaId' => 123,
    'peso' => 123,
    'alto' => 123,
    'ancho' => 123,
    'profundidad' => 123,
    'isFeatured' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/products/:id"

	payload := strings.NewReader("{\n  \"nombre\": \"<string>\",\n  \"descripcion\": \"<string>\",\n  \"precio\": 123,\n  \"precioOriginal\": 123,\n  \"stock\": 123,\n  \"categoriaId\": 123,\n  \"marcaId\": 123,\n  \"peso\": 123,\n  \"alto\": 123,\n  \"ancho\": 123,\n  \"profundidad\": 123,\n  \"isFeatured\": true\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/api/products/:id")
  .header("Content-Type", "application/json")
  .body("{\n  \"nombre\": \"<string>\",\n  \"descripcion\": \"<string>\",\n  \"precio\": 123,\n  \"precioOriginal\": 123,\n  \"stock\": 123,\n  \"categoriaId\": 123,\n  \"marcaId\": 123,\n  \"peso\": 123,\n  \"alto\": 123,\n  \"ancho\": 123,\n  \"profundidad\": 123,\n  \"isFeatured\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/products/:id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"nombre\": \"<string>\",\n  \"descripcion\": \"<string>\",\n  \"precio\": 123,\n  \"precioOriginal\": 123,\n  \"stock\": 123,\n  \"categoriaId\": 123,\n  \"marcaId\": 123,\n  \"peso\": 123,\n  \"alto\": 123,\n  \"ancho\": 123,\n  \"profundidad\": 123,\n  \"isFeatured\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": 123,
    "nombre": "<string>",
    "descripcion": "<string>",
    "precio": 123,
    "precioOriginal": 123,
    "stock": 123,
    "foto": "<string>",
    "isFeatured": true,
    "peso": 123,
    "alto": 123,
    "ancho": 123,
    "profundidad": 123,
    "categoriaId": 123,
    "marcaId": 123,
    "createdAt": {},
    "updatedAt": {}
  }
}

Endpoint

PUT /api/products/:id

Authentication

Admin access required. Only users with the ADMIN role can update products.

Path Parameters

number

required

The unique identifier of the product to update

Request Headers

Content-Type: multipart/form-data
Authorization: Bearer <access_token>

Request Body

This endpoint accepts multipart/form-data to support image upload. All fields are optional - only include fields you want to update.

string

Product name (minimum 3 characters)

string

Product description (minimum 10 characters)

number

Product price (must be positive)

number

Original price (for displaying discounts)

number

Stock quantity (must be non-negative integer)

number

Category ID to associate with this product

number

Brand ID to associate with this product

number

Product weight in kg

number

Product height in cm

number

Product width in cm

number

Product depth in cm

boolean

Whether this product should be featured

file

Product image file (uploaded as multipart form data). If provided, replaces the existing image.

Response

boolean

Indicates if the product was updated successfully

object

The updated product object

number

Unique product identifier

string

Product name

string

Product description

decimal

Product price

decimal

Original price

number

Stock quantity

string

Product image URL

boolean

Featured status

decimal

Weight in kg

number

Height in cm

number

Width in cm

number

Depth in cm

number

Category ID

number

Brand ID

datetime

Creation timestamp

datetime

Last update timestamp

Example Request

curl -X PUT "https://api.pcfix.com/api/products/42" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -F "precio=69.99" \
  -F "stock=75" \
  -F "isFeatured=false"

Example Response

{
  "success": true,
  "data": {
    "id": 42,
    "nombre": "Gaming Mouse Pro",
    "descripcion": "High-precision gaming mouse with RGB lighting and customizable buttons",
    "precio": "69.99",
    "precioOriginal": "79.99",
    "stock": 75,
    "foto": "https://cdn.pcfix.com/uploads/mouse-image-1234567890.jpg",
    "isFeatured": false,
    "peso": "0.15",
    "alto": 5,
    "ancho": 8,
    "profundidad": 12,
    "categoriaId": 8,
    "marcaId": 3,
    "createdAt": "2024-03-05T10:30:00Z",
    "updatedAt": "2024-03-05T15:45:00Z"
  }
}

Error Responses

Invalid Product ID

{
  "success": false,
  "error": "Product not found"
}

Validation Error

{
  "success": false,
  "error": "Datos inválidos",
  "details": [
    {
      "field": "precio",
      "message": "El precio debe ser positivo"
    }
  ]
}

Unauthorized

{
  "success": false,
  "error": "Unauthorized - Admin access required"
}

Server Error

{
  "success": false,
  "error": "Error message description"
}

Notes

Only include fields you want to update in the request body
If a new image is uploaded, it will replace the existing image
The updatedAt timestamp is automatically updated
Product dimensions and weight are important for shipping calculations

⌘I

Authentication

Products

Cart & Checkout

Sales

Admin

Update Product

Endpoint

Authentication

Path Parameters

Request Headers

Request Body

Response

Example Request

Example Response

Error Responses

Invalid Product ID

Validation Error

Unauthorized

Server Error

Notes

​Endpoint

​Authentication

​Path Parameters

​Request Headers

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

​Invalid Product ID

​Validation Error

​Unauthorized

​Server Error

​Notes

Endpoint

Authentication

Path Parameters

Request Headers

Request Body

Response

Example Request

Example Response

Error Responses

Invalid Product ID

Validation Error

Unauthorized

Server Error

Notes