arrow_back Back to all endpoints
POST https://test-api.finerworks.com/v3/add_images

Add Images Files

Allows the user to add images to a library.

Body

Name Description Type Additional information
images Image objects data to submit. This assumes the image files will be posted to a url. Insert up to 5 at once. array (add_image_details)

Required

library Contains parameters which indicate the location of the image. image_library

Required

Example JSON Body

application/json, text/json

{
  "images": [
    {
      "title": "My Cool Image",
      "description": "This is a really cool picture.",
      "file_name": "abc.jpg",
      "file_size": 11000024,
      "thumbnail_file_name": "thumbnail.jpg",
      "preview_file_name": "preview.jpg",
      "hires_file_name": "hires.jpg",
      "public_thumbnail_uri": "https://somewhere.com/public_thumbnail_uri.jpg",
      "public_preview_uri": "https://somewhere.com/public_preview_uri.jpg",
      "private_hires_uri": "https://somewhere.com/private_hires_uri.jpg",
      "pix_w": 1600,
      "pix_h": 2400,
      "guid": null
    }
  ],
  "library": {
    "name": "inventory",
    "session_id": "1234567890",
    "account_key": "",
    "site_id": 2
  }
}

Sample Code Library

curl --location --request POST 'https://test-api.finerworks.com/v3/add_images' \
--header 'Content-Type: application/json' \
--header 'web_api_key: my-web-api-key-goes-here' \
--header 'app_key: my-app-key-goes-here' \
--data-raw '{
  "images": [
    {
      "title": "My Cool Image",
      "description": "This is a really cool picture.",
      "file_name": "abc.jpg",
      "file_size": 11000024,
      "thumbnail_file_name": "thumbnail.jpg",
      "preview_file_name": "preview.jpg",
      "hires_file_name": "hires.jpg",
      "public_thumbnail_uri": "https://somewhere.com/public_thumbnail_uri.jpg",
      "public_preview_uri": "https://somewhere.com/public_preview_uri.jpg",
      "private_hires_uri": "https://somewhere.com/private_hires_uri.jpg",
      "pix_w": 1600,
      "pix_h": 2400,
      "guid": null
    }
  ],
  "library": {
    "name": "inventory",
    "session_id": "1234567890",
    "account_key": "",
    "site_id": 2
  }
}'