The Catalog Images app provides REST and GraphQL APIs for users to save or delete catalog images on File Manager without overriding images with the same name.

Using the VTEX IO CLI, log in to your desired account and workspace and run the following command to install the Catalog Images app:

Once the installation is confirmed, you can use the Catalog Images app's resources through REST API or GraphQL as long as you follow the authentication process.

First, you must have an appKey and appToken to use as authentication headers in this application’s requests. Read Authentication for more information on how to obtain these credentials.

Using your appKey and appToken, make the following API request to obtain a local token, which is required by the app. Replace {{accountName}} with your VTEX account name and {{my_appkey}} and {{my_apptoken}} with their respective values.

Request local token:

Response:

The token value you will receive as a response is required for authentication in the app's API calls, explained in the following sections.

There are two REST API endpoints available to manage images using the Catalog Images app:

• POST Save image
• DELETE Delete image

To save an image in File Manager, use the request below. Make sure to send one image at a time and set the request body format to multipart/form-data.

Make sure to replace the following values in your request:

Property	Location	Type	Description	Example
accountName	Path	String	Name of the VTEX account.	mystore
workspace	Path	String	Name of the workspace where you want to upload the image.	master
fileName	Path	String	Name and extension of the image file.	product.png
token	Header (VtexIdClientAutCookie)	-	Local token required for authentication.	-
filePath	Request body	String	Full path of the file.	/C:/Images/product.png

If there is already an image with the same filename given, the response will be Conflict (409) with the conflicted image URL in the response body.

Otherwise, the response will be OK (200) with the id, slug, and fullUrl in the response body, as follows:

Response body example (200 OK):

The following REST API route allows you to delete a Catalog image in File Manager:

Replace the values as explained below:

Property	Location	Type	Description	Example
accountName	Path	String	Name of the VTEX account.	mystore
workspace	Path	String	Name of the workspace where you want to upload the image.	master
fileName	Path	String	Name and extension of the image file.	product.png
token	Header (VtexIdClientAutCookie)	-	Local token required for authentication.	-

If there is already an image with the same fileName given, the response will be Conflict (409) with the conflicted image URL in the response body.

If the image exists and is successfully deleted, the response will be an empty body with status code OK (200). If the image does not exist, the response will be Not Found (404).

The following mutations are available for Catalog images using the app’s GraphQL API:

• saveImage
• deleteImage

Use the following mutation to save an image on File Manager using GraphQL:

Mutation:

Response body example (200 OK):

If there is already an image with the same name registered on File Manager, the response will contain an array of errors, including CONFLICT_FILE_ERROR.

Response body example (409 Conflict):

Use the following mutation to delete an image on File Manager using GraphQL:

Mutation:

Response body example (200 OK):

If the image does not exist, the statusCode value in the response will be NotFound.