---
title: "Upload and link image to product"
method: POST
path: "/products/v1/resources/image/uploadAndLink"
tags: ["Product Management API"]
---

# Upload and link image to product

`POST /products/v1/resources/image/uploadAndLink`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/products/v1/resources/image/uploadAndLink`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/products/v1/resources/image/uploadAndLink/post.ts> (a function with typed inputs; its response is checked against the schema)

Uploads an image file and links it to a specific product resource. Supports various image types for different use cases like logos, screenshots, and overview images. The uploaded image is automatically processed and stored in the appropriate format for the specified upload type.

## Request body `multipart/form-data`

- object
  - `productRefId` string, required: Product reference ID to link the image to
  - `uploadType` 'PROFILE_LOGO' | 'MYAPPS_LOGO' | 'LISTING_LOGO' | 'LISTING_AND_MYAPPS_LOGO' | 'OVERVIEW' | 'SCREENSHOT' | 'FEATURE', required: Type of upload specifying where the image will be used
  - `locale` string, required: Locale for the image (ISO 639-1 language code with optional country code)
  - `file` string, binary, required: Image file to upload (supported formats: JPG, PNG, GIF)
  - `identifier` string: Optional identifier for the uploaded image resource

## Response `201`

Image uploaded and linked successfully

## Other responses

- `400`: Bad Request - Invalid parameters
- `401`: Unauthorized - Authentication required
- `403`: Forbidden - Insufficient permissions
- `500`: Internal Server Error - Unexpected error uploading and linking image

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/products/v1/resources/image/uploadAndLink/post.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)