> For the complete documentation index, see [llms.txt](https://db.coolstone.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://db.coolstone.dev/browser/modify.md).

# Modify

## Modify Record Content (JSON Only) <a href="#content" id="content"></a>

{% code lineNumbers="true" %}

```javascript
db.get('tag').setValue('key','value')
```

{% endcode %}

{% hint style="info" %}
For non-JSON, use [`overwrite()`](#overwrite)
{% endhint %}

### Parameters

<table><thead><tr><th>Name</th><th>About</th><th>Type</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>tag</td><td>The Record's tag</td><td>String</td><td>true</td></tr><tr><td>key</td><td>The key to change</td><td>String</td><td>true</td></tr><tr><td>value</td><td>The value to set to</td><td>Any</td><td>true</td></tr></tbody></table>

## Append data to Record <a href="#append" id="append"></a>

{% hint style="warning" %}
Do not use this with JSON records.
{% endhint %}

{% code lineNumbers="true" %}

```javascript
db.get('tag').append(data)
```

{% endcode %}

<table><thead><tr><th>Name</th><th>About</th><th>Type</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>data</td><td>The data to add</td><td>Any</td><td>true</td></tr></tbody></table>

## Change the length of a Record <a href="#length" id="length"></a>

{% code lineNumbers="true" %}

```javascript
db.get('tag').truncate(start,end)
```

{% endcode %}

<table><thead><tr><th>Name</th><th>About</th><th>Type</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>start</td><td>Index to start at</td><td>Number</td><td>true</td></tr><tr><td>end</td><td>Index to stop at</td><td>Number</td><td>true</td></tr></tbody></table>

## Overwrite Record Content <a href="#overwrite" id="overwrite"></a>

{% code lineNumbers="true" %}

```javascript
db.get('tag').overwrite(data)
```

{% endcode %}

### Parameters

<table><thead><tr><th>Name</th><th>About</th><th>Type</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>tag</td><td>The Record's tag</td><td>String</td><td>true</td></tr><tr><td>data</td><td>The data to overwrite with</td><td>Any (must match file extension)</td><td>true</td></tr></tbody></table>

## Modify Record's tag <a href="#tag" id="tag"></a>

{% code lineNumbers="true" %}

```javascript
db.get('old_tag').setTag('new_tag')
```

{% endcode %}

### Parameters

<table><thead><tr><th>Name</th><th>About</th><th>Type</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>old_tag</td><td>The current tag of the Record.</td><td>String</td><td>true</td></tr><tr><td>new_tag</td><td>The new tag you want for the Record.</td><td>String</td><td>true</td></tr></tbody></table>

## Overwrite Data from another Record <a href="#syncwith" id="syncwith"></a>

{% code lineNumbers="true" %}

```javascript
db.get('tag').syncWith('_tag')
```

{% endcode %}

### Parameters

<table><thead><tr><th>Name</th><th>About</th><th>Type</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>_tag</td><td>The tag of the Record you want to get the data from.</td><td>String</td><td>true</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://db.coolstone.dev/browser/modify.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.