# Data Update Record with ID

{% hint style="info" %}
**Block Information**

Available in: Page Flow and Cloud Flow

Toolbox Category: Data - Edit

Block Type: [Regular](/app-editor/page-flow/block-anatomy.md#regular-block)
{% endhint %}

**`Data Update Record with ID`** is a [regular block](/app-editor/page-flow/block-anatomy.md#regular-block) that initiates the modification/update of a [record](/app-editor/data/database-tables.md#table-records) in a [database table](/app-editor/data/database-tables.md).

<div align="left"><figure><img src="/files/5wkeK3knSiCZLxT1TqnJ" alt="" width="211"><figcaption><p>Data Update Record with ID block</p></figcaption></figure></div>

The block consists of the following (from top to bottom):

* *Table:* [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts a [*text*](/app-editor/page-flow/references/value-types.md) value representing the name of the [Database Table](/app-editor/data/database-tables.md) .
* *Dataset Name:* [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts a [*text*](/app-editor/page-flow/references/value-types.md) value representing the name of the dataset. This can be any [*text*](/app-editor/page-flow/references/value-types.md) value and can later be used to track the completion.
* *Dataset Refresh*: [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts a [boolean](/app-editor/page-flow/references/value-types.md) (true/false) value to indicate if you want the system to refresh the records in the same dataset after successful completion.
* *Record ID*: [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts a [*text*](/app-editor/page-flow/references/value-types.md) value representing the identifier for the record being modified/updated.
* *Set fields to*: [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts an [object](/app-editor/page-flow/references/value-types.md) value representing the record to be added. The Object block is pre-attached by default and its properties are automatically populated based on the fields of the selected table.&#x20;

{% hint style="success" %}
**NOTE**:&#x20;

* This block initiates the database record update operation, which will occur in the background. To track the status and to take an action upon completion, use the [Data Status](/app-editor/page-flow/toolbox-blocks/data-status.md) block.
* &#x20;For the *Set fields to* [value parameter](/app-editor/page-flow/block-anatomy.md#value-parameters), you only have to provide values for the fields you want to modify/update and can leave the other fields unassigned.
  {% endhint %}

***

## Usage Example

{% hint style="info" %}
**NOTE: Please refer to the prerequisite information shown** [**here**](/app-editor/page-flow/references/prerequisite-for-data-examples.md) **before seeing the example.**&#x20;
{% endhint %}

The image below shows an example of **`Data Update Record with ID`** the block.&#x20;

In this example we will be modifying the *Notes* field for the record with identifier *64f1018ab5ed96040cc633b3* . As this is the same record we added in the example for the [Data Add Record](/app-editor/page-flow/toolbox-blocks/data-add-record.md) block, please take a moment to go over that [example](/app-editor/page-flow/toolbox-blocks/data-add-record.md#usage-example).

<figure><img src="/files/k3WXVnxh91FTceLqPg9r" alt=""><figcaption><p>Example of Data Update Record with ID</p></figcaption></figure>

Here is a summary of the above example:

* The [Event Action](/app-editor/page-flow/toolbox-blocks/event-action.md) block is used to handle a [click](/app-editor/page-flow/toolbox-blocks/event-action.md#event-names) event for a button.
* The **`Data Update Record with ID`** block is used to modify/update the record with identifier *64f1018ab5ed96040cc633b3* in the *Customers* database table. The record is for the name *Jane Max* .
* Only the *Notes* field has a value specified (*Modified Notes*). All other fields do not have any value assigned. This will ensure that only the *Notes* field is modified.
* The [Data Status](/app-editor/page-flow/toolbox-blocks/data-status.md) block is used to track the completion of the database update operation.
* Upon a successful completion, the [Show Information Popup](/app-editor/page-flow/toolbox-blocks/show-information-popup.md) block is used to display a message that the operation is complete.

The *Customers* database table now contains the following, with the record we modified highlighted:

<figure><img src="/files/jpAT9cPa8mvoDZwQ9pWA" alt=""><figcaption><p>Database records after the above example completes</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zingy.ai/app-editor/page-flow/toolbox-blocks/data-update-record-with-id.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
