> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://dev.rechain.co/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://dev.rechain.co/_mcp/server.

# Reorder product photos

PUT https://api.rechain.co/public/v1/product_photos/reorder
Content-Type: application/json

Requires products:update. Include every current photo ID exactly once in the desired order. Missing, duplicate, or foreign photo IDs return 422 and leave the collection unchanged. The server assigns contiguous positions starting at zero, updates the parent product updatedAt, and returns the reordered array.

Reference: https://dev.rechain.co/api-reference/product-photo/reorder-product-photos

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Body (application/json)

This endpoint expects a ProductPhotoReorder.

- `productId` (string, required)
- `photoIds` (list of string, required) — Every current photo ID for this product, exactly once, in the desired order.

## Response

### 200

Product photos in the requested order.

- `list of ProductPhotoResponse`

## Errors

### 401 Unauthorized Error

Missing, invalid, or revoked API credential.

- `any`

### 403 Forbidden Error

The credential does not allow this product operation.

- `any`

### 404 Not Found Error

The record does not exist or is outside the credential's company/product scope.

- `any`

### 422 Unprocessable Entity Error

Invalid parameters, conflicting image sources, size limits, failed download, or invalid image content.

- `errors` (list of string, optional)
- `error` (string, optional)

## Types

### ProductPhotoResponse

- `id` (string, optional)
- `productId` (string, optional) — ID of the product that owns the image.
- `fileUrl` (string, optional, nullable)
- `position` (integer, optional)
- `createdAt` (datetime, optional)
- `updatedAt` (datetime, optional)
- `description` (string, optional, nullable)

## Examples

**Request**

```json
{
  "productId": "123e4567-e89b-12d3-a456-426614174000",
  "photoIds": [
    "123e4567-e89b-12d3-a456-426614174002",
    "123e4567-e89b-12d3-a456-426614174001"
  ]
}
```

**Response**

```json
[
  {
    "id": "string",
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "fileUrl": "string",
    "position": 1,
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "description": "string"
  }
]
```

**SDK Code**

```python product_photo_reorderProductPhotos_example
import requests

url = "https://api.rechain.co/public/v1/product_photos/reorder"

payload = {
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "photoIds": ["123e4567-e89b-12d3-a456-426614174002", "123e4567-e89b-12d3-a456-426614174001"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.json())
```

```javascript product_photo_reorderProductPhotos_example
const url = 'https://api.rechain.co/public/v1/product_photos/reorder';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"productId":"123e4567-e89b-12d3-a456-426614174000","photoIds":["123e4567-e89b-12d3-a456-426614174002","123e4567-e89b-12d3-a456-426614174001"]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go product_photo_reorderProductPhotos_example
package main

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

func main() {

	url := "https://api.rechain.co/public/v1/product_photos/reorder"

	payload := strings.NewReader("{\n  \"productId\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"photoIds\": [\n    \"123e4567-e89b-12d3-a456-426614174002\",\n    \"123e4567-e89b-12d3-a456-426614174001\"\n  ]\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby product_photo_reorderProductPhotos_example
require 'uri'
require 'net/http'

url = URI("https://api.rechain.co/public/v1/product_photos/reorder")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"productId\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"photoIds\": [\n    \"123e4567-e89b-12d3-a456-426614174002\",\n    \"123e4567-e89b-12d3-a456-426614174001\"\n  ]\n}"

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

```java product_photo_reorderProductPhotos_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.put("https://api.rechain.co/public/v1/product_photos/reorder")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"productId\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"photoIds\": [\n    \"123e4567-e89b-12d3-a456-426614174002\",\n    \"123e4567-e89b-12d3-a456-426614174001\"\n  ]\n}")
  .asString();
```

```php product_photo_reorderProductPhotos_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://api.rechain.co/public/v1/product_photos/reorder', [
  'body' => '{
  "productId": "123e4567-e89b-12d3-a456-426614174000",
  "photoIds": [
    "123e4567-e89b-12d3-a456-426614174002",
    "123e4567-e89b-12d3-a456-426614174001"
  ]
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp product_photo_reorderProductPhotos_example
using RestSharp;

var client = new RestClient("https://api.rechain.co/public/v1/product_photos/reorder");
var request = new RestRequest(Method.PUT);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"productId\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"photoIds\": [\n    \"123e4567-e89b-12d3-a456-426614174002\",\n    \"123e4567-e89b-12d3-a456-426614174001\"\n  ]\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift product_photo_reorderProductPhotos_example
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "productId": "123e4567-e89b-12d3-a456-426614174000",
  "photoIds": ["123e4567-e89b-12d3-a456-426614174002", "123e4567-e89b-12d3-a456-426614174001"]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.rechain.co/public/v1/product_photos/reorder")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PUT"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```