Bulk Add Image Relationships

Creates relationships between an image and up to 100 items (products or variants) with optional priority ordering. Validates that each item exists and is not deleted before creating the relationship. Returns lists of successful and failed relationship creations with error details. Deprecated: use PUT /api/v2/{team_slug}/{app_slug}/dam/images/items instead.

PUT/api/v1/{team_slug}/{app_slug}/images/{image_id}/relationships/bulkdeprecated

Authorization

AuthorizationBearer token · headerrequired

Management API token, sent as Authorization: Bearer <token>.

Path parameters

team_slugstringrequired

Team slug

app_slugstringrequired

App slug

image_idstringrequired

Image ID

Request body

requiredapplication/json

Items to link to the image

itemsinternal_pkg_webserver_v1.BulkAddImageRelationshipItem[]required

max items 100

Show properties

Array of internal_pkg_webserver_v1.BulkAddImageRelationshipItem

item_idstringrequired

item_typestringrequired

Allowed:productvariant

priorityinteger

min 1

Responses

200

Relationships added successfully

datainternal_pkg_webserver_v1.BulkAddImageRelationshipsResponserequired

Show properties

failedinternal_pkg_webserver_v1.BulkAddImageRelationshipFailedOp[] | null

Show properties

Array of internal_pkg_webserver_v1.BulkAddImageRelationshipFailedOp

item_idstring

item_typestring

reasonstring

successfulinternal_pkg_webserver_v1.BulkAddImageRelationshipItem[] | null

Show properties

Array of internal_pkg_webserver_v1.BulkAddImageRelationshipItem

item_idstringrequired

item_typestringrequired

Allowed:productvariant

priorityinteger

min 1

detailsstring[]

Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes

successbooleanrequired

400

Invalid request

detailsstring[]

messagestring

successbooleanrequired

401

Unauthorized access

detailsstring[]

messagestring

successbooleanrequired

404

Image not found

detailsstring[]

messagestring

successbooleanrequired

500

Internal server error

detailsstring[]

messagestring

successbooleanrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

team_slugpath*Team slugapp_slugpath*App slugimage_idpath*Image ID

Bodyapplication/json

Request body

Request

curl -X PUT 'https://api.enad.io/api/v1/string/string/images/string/relationships/bulk' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "items": [
    {
      "item_id": "string",
      "item_type": "product",
      "priority": 1
    }
  ]
}'

const response = await fetch("https://api.enad.io/api/v1/string/string/images/string/relationships/bulk", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"items\": [\n    {\n      \"item_id\": \"string\",\n      \"item_type\": \"product\",\n      \"priority\": 1\n    }\n  ]\n}"
});

import requests

response = requests.put(
    "https://api.enad.io/api/v1/string/string/images/string/relationships/bulk",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"items\": [\n    {\n      \"item_id\": \"string\",\n      \"item_type\": \"product\",\n      \"priority\": 1\n    }\n  ]\n}",
)

Response

{
  "data": {
    "failed": [
      {
        "item_id": "string",
        "item_type": "string",
        "reason": "string"
      }
    ],
    "successful": [
      {
        "item_id": "string",
        "item_type": "product",
        "priority": 1
      }
    ]
  },
  "details": [
    "string"
  ],
  "success": true
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": true
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": true
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": true
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": true
}