---
title: "List image URLs"
method: POST
path: "/imageurls"
tags: ["cellImages"]
---

# List image URLs

`POST /imageurls`

Posts an array of Image Url objects that can be used to retrieve the specified cell images.

## Request body

- ImageUrl[]
  - `imageId` string — Image ID.
  - `error` Error — The error caused by the failed item.
    - `refId` string — The ID of the specific error occurrence. Please include this information when contacting Smartsheet support.
    - `errorCode` number — Custom error code from Smartsheet. See the complete [Error Code List](/api/smartsheet/error-codes).
    - `message` string — Descriptive error message.
  - `height` number — Image height in pixels.
  - `url` string — Temporary URL that can be used to retrieve the image. This attribute can be present in a response but is never specified in a request.
  - `width` number — Image width in pixels.

## Response `200`

OK

- ImageUrlMap
  - `imageUrls` ImageUrl[]
    - `imageId` string — Image ID.
    - `error` Error — The error caused by the failed item.
      - `refId` string — The ID of the specific error occurrence. Please include this information when contacting Smartsheet support.
      - `errorCode` number — Custom error code from Smartsheet. See the complete [Error Code List](/api/smartsheet/error-codes).
      - `message` string — Descriptive error message.
    - `height` number — Image height in pixels.
    - `url` string — Temporary URL that can be used to retrieve the image. This attribute can be present in a response but is never specified in a request.
    - `width` number — Image width in pixels.
  - `urlExpiresInMillis` number — Milliseconds before the URLs within imageUrls expire.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)