--- title: "Update an update request" method: PUT path: "/sheets/{sheetId}/updaterequests/{updateRequestId}" tags: ["updateRequests"] --- # Update an update request `PUT /sheets/{sheetId}/updaterequests/{updateRequestId}` Changes the specified update request for the sheet. **Making changes to update requests that do not have future scheduled delivery is not allowed.** The UpdateRequest object in the request body must specify one or more of the following attributes: * **ccMe:** Boolean * **columnIds:** number[] * **includeAttachments:** Boolean * **includeDiscussions:** Boolean * **message:** string * **schedule:** Schedule object * **sendTo:** Recipient[] * **subject:** string If an error occurs because the request specified one or more *alternate email addresses*, please retry using the primary email address. ## Headers - `Content-Type` string ## Response `200` Result object containing the modified UpdateRequest object - object - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.) - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation - `failedItems` BulkItemFailure[], nullable — Array of BulkItemFailure objects which represents the items that failed to be added or updated. See [Bulk operations > Partial success](/api/smartsheet/guides/advanced-topics/scalability-options) for more information. Applicable only for bulk operations that support partial success. - `rowId` number, nullable — The ID of the row that failed. Applicable only to bulk row operations. - `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. - `index` number — The index of the failed item in the bulk request array. - `version` number, nullable — New version of the sheet. Applicable only for operations which update sheet data. - `result` UpdateRequest - `ccMe` boolean — Indicates whether to send a copy of the email to the sender. - `message` string — The message of the email. - `sendTo` Recipient[] — Array of recipients. - union — Specifies the recipient of an email. The recipient may be either an individual or a group. To specify an individual, set the email attribute; to specify a group, set the groupId attribute. Either email and groupId may be set, but not both. - RecipientIndividual — Specifies the recipient of an [Email](/api/smartsheet/openapi/schemas/email). The recipient may be either an individual or a group. To specify an individual, set the `email` attribute; to specify a group, set the `groupId` attribute. Either `email` and `groupId` may be set, but not both. - `email` string, email — The email address of an individual recipient. - RecipientGroup — Specifies the recipient of an [Email](/api/smartsheet/openapi/schemas/email). The recipient may be either an individual or a group. To specify an individual, set the `email` attribute; to specify a group, set the `groupId` attribute. Either **email** and `groupId` may be set, but not both. - `groupId` number — The ID of a group recipient. - `subject` string — The subject of the email. - `columnIds` number[] — The ID of the columns to be included. - `includeAttachments` boolean — Indicates whether to include attachments in the email. - `includeDiscussions` boolean — Indicates whether to include discussions in the email. - `layout` boolean — One of the following values: **HORIZONTAL** or **VERTICAL**. Optional, defaults to **HORIZONTAL** when multiple rows are being sent and to **VERTICAL** when a single row is being sent. **HORIZONTAL** formats the rows being sent as a grid, whereas **VERTICAL** formats the rows being sent as separate cards. - `rowIds` number[] — The Ids of rows to be included. - `id` number — ID of the update request. - `createdAt` union - string, date-time - number - `modifiedAt` union - string, date-time - number - `schedule` Schedule - `type` 'ONCE' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY' — Type of schedule. - `dayDescriptors` string[] — A string array consists of one or more of the following values: * **DAY**, **WEEKDAY**, **WEEKEND** * **SUNDAY**, **MONDAY**, **TUESDAY**, **WEDNESDAY**, **THURSDAY**, **FRIDAY**, **SATURDAY** The subset of values applicable to the schedule type are as followed: | Value | Daily schedule | Weekly schedule | Monthly schedule | |---------------|----------------|-----------------|------------------| | **DAY** | | | **✓** | | **WEEKDAY** | **✓** | | **✓** | | **WEEKEND** | | | **✓** | | **SUNDAY** | | **✓** | **✓** | | **MONDAY** | | **✓** | **✓** | | **TUESDAY** | | **✓** | **✓** | | **WEDNESDAY** | | **✓** | **✓** | | **THURSDAY** | | **✓** | **✓** | | **FRIDAY** | | **✓** | **✓** | | **SATURDAY** | | **✓** | **✓** | For more details, refer to the Table of Schedule Object’s Attributes below. - `dayOfMonth` number — The day within the month. Valid range is 1 to 28. This attribute is applicable to the following schedule type: * **MONTHLY** For more details, refer to the Table of Schedule Object’s Attributes below. - `dayOrdinal` 'FIRST' | 'LAST' | 'SECOND' | 'THIRD' | 'FOURTH' — Must be one of the following values: * **FIRST** or **LAST** * **SECOND**, **THIRD**, or **FOURTH** This attribute is applicable to the following schedule type: * **MONTHLY** For more details, refer to the Table of Schedule Object’s Attributes below. - `repeatEvery` number — Frequency on which the request is delivered. The unit is a function of the **type** attribute. For example, for **MONTHLY** schedule, **repeatEvery=1** means every month. Valid range is 1 to 99. This attribute is applicable to the following schedule types: **DAILY**, **WEEKLY**, **MONTHLY**, or **YEARLY**. For more details, refer to the Table of Schedule Object’s Attributes below. - `endAt` union - string, date-time — The date, time, and time zone at which the delivery schedule ends. The value is either in a string format or a numeric format: * When the value is a string, it must be a valid ISO-8601 date and time with an offset (YYYY-MM-DDThh:mm:ssTZD). * When the value is a number, it represents a date and time with no offset (UTC time zone). See Dates and Times for more information. The value must be later than startAt and the current date and time. The value must contain zero hours, zero minutes, and zero seconds. The offset (time zone) value must be the same as the offset (time zone) value in startAt. This attribute is applicable to the following schedule types: DAILY, WEEKLY, MONTHLY, YEARLY. For more details, refer to the Table of Schedule Object’s Attributes below. - number — The date, time, and time zone at which the delivery schedule ends. The value is either in a string format or a numeric format: * When the value is a string, it must be a valid ISO-8601 date and time with an offset (YYYY-MM-DDThh:mm:ssTZD). * When the value is a number, it represents a date and time with no offset (UTC time zone). See Dates and Times for more information. The value must be later than startAt and the current date and time. The value must contain zero hours, zero minutes, and zero seconds. The offset (time zone) value must be the same as the offset (time zone) value in startAt. This attribute is applicable to the following schedule types: DAILY, WEEKLY, MONTHLY, YEARLY. For more details, refer to the Table of Schedule Object’s Attributes below. - `lastSentAt` union - string, date-time — The date and time for when the last request was sent. - number — The date and time for when the last request was sent. - `nextSendAt` union - string, date-time — The date and time for when the next request is scheduled to send. - number — The date and time for when the next request is scheduled to send. - `startAt` union - string, date-time — The date, time, and time zone at which the first delivery starts. The value is either in a string format or a numeric format: * When the value is a string, it must be a valid ISO-8601 date and time with an offset (YYYY-MM-DDThh:mm:ssTZD). * When the value is a number, it represents a date and time with no offset (UTC time zone). See [Dates and times](/api/smartsheet/guides/basics/dates-and-times) for more information. For ONCE schedule type, it must be later than the current date time. For all other schedule types, it must be later than “2000-01-01T00:00:00Z” in string format or 946684800000 in numeric format. The value must contain zero minutes and zero seconds. This attribute is applicable to all schedule types. For more details, refer to the Table of Schedule Object’s Attributes below. - number — The date, time, and time zone at which the first delivery starts. The value is either in a string format or a numeric format: * When the value is a string, it must be a valid ISO-8601 date and time with an offset (YYYY-MM-DDThh:mm:ssTZD). * When the value is a number, it represents a date and time with no offset (UTC time zone). See [Dates and times](/api/smartsheet/guides/basics/dates-and-times) for more information. For ONCE schedule type, it must be later than the current date time. For all other schedule types, it must be later than “2000-01-01T00:00:00Z” in string format or 946684800000 in numeric format. The value must contain zero minutes and zero seconds. This attribute is applicable to all schedule types. For more details, refer to the Table of Schedule Object’s Attributes below. - `sentBy` MiniUser — MiniUser Object - `email` string, email - `name` string --- [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)