---
title: "Upload image for use by the search creative images/videos operations"
method: PUT
path: "/v3/search/by-image/uploads/{file-name}"
tags: ["Search"]
---

# Upload image for use by the search creative images/videos operations

`PUT /v3/search/by-image/uploads/{file-name}`

## Request

- Base URL: `https://api.gettyimages.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gettyimages.com/v3/search/by-image/uploads/{file-name}`
- Auth: one of:
  - API key in header `Api-Key`
  - OAuth 2
    - Authorization code: `https://authentication.gettyimages.com/oauth2/auth`
    - Client credentials
    - Password
    - Token URL: `https://authentication.gettyimages.com/oauth2/token`
- TypeScript: <https://skmtc.dev/gettyimages/apis/getty-images-api/docs/v3/search/by-image/uploads/:file-name/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `file-name` string, required

## Request body `image/jpeg`

- string, byte

## Response `200`

OK

## Other responses

- `400`: InvalidParameterValue
- `401`: AuthorizationTokenRequired
- `403`: UnauthorizedDisplaySize

## Changes

- **2025-11-20** `81cb0e852242`: 2 breaking
  - the request's body became not nullable (media type: image/jpeg)
  - the request's body became not nullable (media type: image/png)

[Operation history](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/search/by-image/uploads/:file-name/put.md)

---

[API](https://skmtc.dev/gettyimages/apis/getty-images-api.md) - [All operations](https://skmtc.dev/gettyimages/apis/getty-images-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gettyimages/apis/getty-images-api/revisions/f20ce986456b?raw)