# record-update

The dns record-update command updates an existing DNS record in a specific DNS zone. This command requires the DNS zone ID, record ID, and updated record details.

## Usage

```
cldkctl dns record-update [zone_id] [record_id] [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. A DNS record can be updated by running the command with flags:

```
cldkctl dns record-update [dns-zone-id] [record-id] --type [record-type] --name [record-name] --content [record-content] --ttl [record-ttl]
```

2. Replace `[dns-zone-id]` with the ID of the DNS zone. Refer to dns list section to obtain the DNS zone ID.
3. Replace `[record-id]` with the ID of the DNS record. Refer to dns record-list section to obtain the record ID.
4. Replace `[record-type]` with the DNS record type.
5. Replace `[record-name]` with the record name.
6. Replace `[record-content]` with the record value.
7. Replace `[record-ttl]` with the desired TTL (time to live) value.
8. Or alternatively, run the command without flags to update a DNS record interactively using TUI mode:

```
cldkctl dns record-update [dns-zone-id] [record-id]
```

9. The Type field displays the current DNS record type.
10. The Name field allows editing of the DNS record name.
11. The IPv4 Address (or record content) field allows editing of the record value.
12. The TTL field allows editing of the record’s time to live value.

<figure><img src="/files/o88aI6RJsFcl9Hht6OlR" alt=""><figcaption></figcaption></figure>

13. Confirm the record update by pressing y for Confirm or n for Cancel.

<figure><img src="/files/QKvuTxGxroSQV4nHdb3S" alt=""><figcaption></figcaption></figure>

14. Once completed successfully, a message **“✓ DNS record updated successfully!**” will appear in the terminal.

<figure><img src="/files/yuAAcXzc23C7X0iQWCp6" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="info" %}
This command supports [global flags](/guidance-for-individual/cloudeka-api-list/global-flags.md). Refer to the Global Flags section for details.
{% endhint %}

| Flag                 | Description                                    |
| -------------------- | ---------------------------------------------- |
| -c, --content string | DNS record content.                            |
| -h, --help           | Help for dns record create command.            |
| -n, --name string    | DNS record name.                               |
| --ttl int            | DNS record TTL (time to live) (default 86400). |
| -t, --type string    | DNS record type.                               |


---

# 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://docs.cloudeka.ai/guidance-for-individual/cloudeka-api-list/command-reference/cldkctl-dns/record-update.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.