Posts an array of Image Url objects that can be used to retrieve the specified cell images.
Authorization | string API Access Token used to authenticate requests to Smartsheet APIs. Example: Bearer JKlMNOpQ12RStUVwxYZAbcde3F5g6hijklM789 |
Content-Type | string Default: application/json Required for POST and PUT requests. Defines the structure for the request body. |
imageId | string Image Id. |
object The error caused by the failed item. | |
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. |
[- {
- "imageId": "string",
- "error": {
- "refId": "string",
- "errorCode": 0,
- "message": "string"
}, - "height": 0,
- "url": "string",
- "width": 0
}
]
{- "imageUrls": [
- {
- "imageId": "string",
- "error": {
- "refId": "string",
- "errorCode": 0,
- "message": "string"
}, - "height": 0,
- "url": "string",
- "width": 0
}
], - "urlExpiresInMillis": 0
}
Uploads an image to the specified cell within a sheet.
sheetId required | number Sheet Id of the sheet being accessed. |
rowId required | number Row Id in the sheet being accessed. |
columnId required | number Column Id in the sheet being accessed. |
altText | string Url-encoded alternate text for the image |
overrideValidation | boolean Default: false You may use the query string parameter overrideValidation with a value of true to allow a cell value outside of the validation limits. You must specify strict with a value of false to bypass value type checking. |
Authorization | string API Access Token used to authenticate requests to Smartsheet APIs. Example: Bearer JKlMNOpQ12RStUVwxYZAbcde3F5g6hijklM789 |
Content-Type | string Default: application/json Required for POST and PUT requests. Defines the structure for the request body. |
Content-Disposition | string Should be equal to "attachment" to tell the API that a file is in the body of the POST request, followed by a semicolon, followed by filename= and the URL-encoded filename in quotes Example: attachment; filename="ProgressReport.docx" |
Content-Length | integer Must be set to the size of the file, in bytes. For example to determine file size using in UNIX: $ ls -l ProgressReport.docx 5463 ProgressReport.docx Example: 5463 |
curl 'https://api.smartsheet.com/2.0/sheets/{sheetId}/rows/{rowId}/columns/{columnId}/cellimages?altText=my%20image' \ -H "Authorization: Bearer JKlMNOpQ12RStUVwxYZAbcde3F5g6hijklM789" \ -H "Content-Type: image/jpeg" \ -H 'Content-Disposition: attachment; filename="picture.jpg"' \ -H "Content-Length: FILE_SIZE" \ -X POST \ --data-binary @picture.jpg
{- "version": 0,
- "failedItems": [
- {
- "rowId": 0,
- "error": {
- "refId": "string",
- "errorCode": 0,
- "message": "string"
}, - "index": 0
}
], - "message": "SUCCESS",
- "resultCode": 0,
- "result": {
- "id": 0,
- "sheetId": 0,
- "siblingId": 0,
- "accessLevel": "ADMIN",
- "attachments": [
- {
- "id": 0,
- "parentId": 0,
- "attachmentType": "BOX_COM",
- "attachmentSubType": "DOCUMENT",
- "mimeType": "PNG",
- "parentType": "COMMENT",
- "createdAt": "2019-08-24T14:15:22Z",
- "createdBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "name": "string",
- "sizeInKb": 0,
- "url": "string",
- "urlExpiresInMillis": 0
}
], - "cells": [
- {
- "columnId": 0,
- "columnType": "string",
- "conditionalFormat": "string",
- "displayValue": "string",
- "format": "string",
- "formula": "string",
- "hyperlink": {
- "reportId": 0,
- "sheetId": 0,
- "sightId": 0,
- "url": "string"
}, - "image": {
- "altText": "string",
- "height": 0,
- "id": "string",
- "width": 0
}, - "linkInFromCell": {
- "columnId": 0,
- "rowId": 0,
- "sheetId": 0,
- "sheetName": "string",
- "status": "BLOCKED"
}, - "linksOutToCells": [
- {
- "columnId": 0,
- "rowId": 0,
- "sheetId": 0,
- "sheetName": "string",
- "status": "BLOCKED"
}
], - "objectValue": {
- "objectType": "ABSTRACT_DATETIME",
- "value": "2025-03-03T16:59:59"
}, - "overrideValidation": true,
- "strict": true,
- "value": "string"
}
], - "columns": [
- {
- "autoNumberFormat": {
- "fill": "string",
- "prefix": "string",
- "startingNumber": 0,
- "suffix": "string"
}, - "contactOptions": [
- {
- "email": "string",
- "name": "string"
}
], - "description": "string",
- "format": "string",
- "formula": "string",
- "hidden": true,
- "id": 0,
- "index": 0,
- "locked": true,
- "lockedForUser": true,
- "options": [
- "string"
], - "primary": true,
- "symbol": "string",
- "systemColumnType": "AUTO_NUMBER",
- "tags": [
- "CALENDAR_END_DATE"
], - "title": "string",
- "type": "ABSTRACT_DATETIME",
- "validation": true,
- "version": 0,
- "width": 0
}
], - "conditionalFormat": ",,1,1,,,,,,,,,,,,,",
- "createdAt": "2019-08-24T14:15:22Z",
- "createdBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "discussions": [
- {
- "accessLevel": "ADMIN",
- "id": 0,
- "comments": [
- {
- "attachments": [
- {
- "id": null,
- "parentId": null,
- "attachmentType": null,
- "attachmentSubType": null,
- "mimeType": null,
- "parentType": null,
- "createdAt": null,
- "createdBy": null,
- "name": null,
- "sizeInKb": null,
- "url": null,
- "urlExpiresInMillis": null
}
], - "createdAt": "2019-08-24T14:15:22Z",
- "createdBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "discussionId": 0,
- "id": 0,
- "modifiedAt": "2019-08-24T14:15:22Z",
- "text": "string"
}
], - "commentAttachments": [
- {
- "id": 0,
- "parentId": 0,
- "attachmentType": "BOX_COM",
- "attachmentSubType": "DOCUMENT",
- "mimeType": "PNG",
- "parentType": "COMMENT",
- "createdAt": "2019-08-24T14:15:22Z",
- "createdBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "name": "string",
- "sizeInKb": 0,
- "url": "string",
- "urlExpiresInMillis": 0
}
], - "commentCount": 0,
- "createdBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "lastCommentedAt": "2019-08-24T14:15:22Z",
- "lastCommentedUser": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "parentId": 0,
- "parentType": "ROW",
- "readOnly": true,
- "title": "string"
}
], - "proof": {
- "id": 0,
- "originalId": 0,
- "name": "string",
- "proofType": "DOCUMENT",
- "proofRequestUrl": "string",
- "version": 0,
- "lastUpdatedAt": "2019-08-24T14:15:22Z",
- "lastUpdatedBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "isCompleted": true,
- "attachments": [
- {
- "id": 0,
- "parentId": 0,
- "attachmentType": "BOX_COM",
- "attachmentSubType": "DOCUMENT",
- "mimeType": "PNG",
- "parentType": "COMMENT",
- "createdAt": "2019-08-24T14:15:22Z",
- "createdBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "name": "string",
- "sizeInKb": 0,
- "url": "string",
- "urlExpiresInMillis": 0
}
], - "discussions": [
- {
- "accessLevel": "ADMIN",
- "id": 0,
- "comments": [
- {
- "attachments": [
- null
], - "createdAt": "2019-08-24T14:15:22Z",
- "createdBy": {
- "email": null,
- "name": null
}, - "discussionId": 0,
- "id": 0,
- "modifiedAt": "2019-08-24T14:15:22Z",
- "text": "string"
}
], - "commentAttachments": [
- {
- "id": 0,
- "parentId": 0,
- "attachmentType": "BOX_COM",
- "attachmentSubType": "DOCUMENT",
- "mimeType": "PNG",
- "parentType": "COMMENT",
- "createdAt": "2019-08-24T14:15:22Z",
- "createdBy": {
- "email": null,
- "name": null
}, - "name": "string",
- "sizeInKb": 0,
- "url": "string",
- "urlExpiresInMillis": 0
}
], - "commentCount": 0,
- "createdBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "lastCommentedAt": "2019-08-24T14:15:22Z",
- "lastCommentedUser": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "parentId": 0,
- "parentType": "ROW",
- "readOnly": true,
- "title": "string"
}
]
}, - "expanded": true,
- "filteredOut": true,
- "format": ",,1,1,,,,,,,,,,,,,",
- "inCriticalPath": true,
- "locked": true,
- "lockedForUser": true,
- "modifiedAt": "2019-08-24T14:15:22Z",
- "modifiedBy": {
- "email": "jane.doe@smartsheet.com",
- "name": "Jane Doe"
}, - "permaLink": "string",
- "rowNumber": 1,
- "version": 0
}
}