Admin APIs

Add an Image to an Item

POST /item_images
Api key auth

Add an image to an item

multipart/form-data

Body

  • item_image object
    Hide item_image attributes Show item_image attributes object
    • item_id string(guid)
    • sort_order integer(int32)

      Sort order of the image

    • file string(binary)

      Image file to upload

Responses

  • 201 application/json

    Image added to item

    Hide response attributes Show response attributes object
    • id string(guid)

      System generated unique identifier. Don't include this in POST request body.

    • item_id string(guid)
    • sort_order integer(int32)

      Sort order of the image

    • url string(uri)
    • created_at string(date-time)
    • updated_at string(date-time)
POST /item_images 
curl \
 --request POST 'https://app.getfoundation.com/api/external/v1/item_images' \
 --header "X-API-Key: $API_KEY" \
 --header "Content-Type: multipart/form-data" \
 --form 'item_image={"item_id":"string","sort_order":1,"file":"@file"}'
Response examples (201) 
{
  "id": "9aa62446-c3b0-42f5-8027-3648daed9d73",
  "item_id": "string",
  "sort_order": 1,
  "url": "https://example.com",
  "created_at": "2025-05-04T09:42:00Z",
  "updated_at": "2025-05-04T09:42:00Z"
}