Skip to main content
PUT
/
v3
/
content
Update Content
curl --request PUT \
  --url https://api.proposales.com/v3/content \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "variation_id": 123,
  "product_id": 123,
  "language": "<string>",
  "title": "<string>",
  "description": "<string>",
  "images": [
    {}
  ]
}'
{
  "data": {
    "product_id": 123,
    "variation_id": 123,
    "message": "<string>"
  }
}

Body

variation_id
number
The variation ID of the product to update. Either this or product_id must be provided.
product_id
number
The product ID to update. Either this or variation_id must be provided. This is often more convenient when you have the product ID rather than the variation ID.
language
string
required
A two-letter ISO 3166-1 alpha-2 language code indicating the language of the content to update.
title
string
The new title of the content in the specified language.
description
string
The new description of the content in the specified language.
images
array
A list of images to replace the existing images of the content. You have two options for providing images:
  1. Using Uploadcare UUID: Upload images to Uploadcare first and provide the UUID
  2. Using URL: Provide a publicly accessible image URL with an empty uuid string. The system will automatically download and upload the image to Uploadcare.
Needs to have this shape:
{
  uuid: string; // UUID from Uploadcare, or empty string "" when using url
  filename?: string;
  mime_type?: string;
  url?: string; // Public image URL (used when uuid is empty)
  size?: number;
  height?: number;
  width?: number;
}[]
Example with Uploadcare UUID:
{
  "uuid": "9a7b8c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "filename": "product.jpg"
}
Example with URL:
{
  "uuid": "",
  "url": "https://example.com/image.jpg"
}
Note:
  • This will replace all existing images. To keep existing images, include them in this array.
  • Pass an empty array [] to remove all images.
  • Images that fail to download from URL will be silently skipped. If all images fail, existing images remain unchanged.

Example Requests

Using product_id:
{
  "product_id": 123,
  "language": "en",
  "title": "Updated Product Title",
  "description": "Updated product description"
}
Using variation_id:
{
  "variation_id": 789,
  "language": "en",
  "title": "Updated Product Title",
  "description": "Updated product description"
}

Response

data
object