{"uid":"cap_LaYjWkPGNTnSY-oMHL7S_","slug":"domains-rapidruntime-com-update-a-dns-record-full-replacement-ad4e8648","name":"Update a DNS Record (Full Replacement)","description":"Full replacement — all fields must be provided. Fetch the record first, then modify.","url":"https://domains.rapidruntime.com/api/v1/domains/{domain}/dns/{recordId}?utm_source=zero.xyz","method":"PUT","headers":{},"bodySchema":{"type":"object","required":["type","host","answer"],"properties":{"ttl":{"type":"number","minimum":300,"description":"TTL in seconds (min 300)"},"host":{"type":"string","description":"Relative hostname (use \"\" for apex)"},"type":{"enum":["A","AAAA","ANAME","CNAME","MX","NS","SRV","TXT"],"type":"string","description":"Record type"},"answer":{"type":"string","description":"Record value"},"priority":{"type":"number","description":"Priority (required for MX and SRV)"}}},"responseSchema":{"type":"object","required":["host","type","answer"],"properties":{"id":{"type":"number"},"ttl":{"type":"number"},"fqdn":{"type":"string"},"host":{"type":"string"},"type":{"type":"string"},"answer":{"type":"string"},"priority":{"type":"number"},"domainName":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"0x20C000000000000000000000b9537d11c60E8b50","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_YoqQR9EHW9bB5NpNH8YW3","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"domains.rapidruntime.com","brandSlug":"domains-rapidruntime-com-mpp","brandBaseUrl":"https://domains.rapidruntime.com","brandDocsUrl":null,"whatItDoes":"Fully replaces an existing DNS record for a domain by record ID — all fields must be provided.","exampleAgentPrompt":"Update the A record (ID 4821) on example.com — change the answer to 203.0.113.42, keep the host as www, and set TTL to 3600 seconds.","exampleUseCases":[{"title":"Fix incorrect mail server priority","prompt":"Our MX record for acme.com (ID 7459) has the wrong priority value. Please update it to priority 10 and keep everything else the same — just fetch it first so we don't lose the current answer value."},{"title":"Renew domain verification TXT record","prompt":"I need to update the TXT record (ID 3342) we use for domain verification on marketing.acme.com. Replace the answer with this new verification string: v=spf1 include:sendgrid.net ~all, keep the TTL at 3600."},{"title":"Switch subdomain to new IPv6 address","prompt":"Update the AAAA record (ID 8104) for api.acme.com to point to the new IPv6 address 2001:0db8:85a3:0000:0000:8a2e:0370:7334. Keep the host as api and don't change the TTL."}],"resultDescription":"Returns the updated DNS record object including its numeric ID, FQDN, host, type, answer value, TTL, priority, and domain name confirming the full replacement was applied.","failureModes":["Missing required fields (type, host, or answer) returns a 400 validation error","Invalid record type (not in A/AAAA/ANAME/CNAME/MX/NS/SRV/TXT enum) returns 400","TTL below 300 seconds fails validation","Priority not provided for MX or SRV record type causes rejection","Non-existent domain or recordId returns 404","Unauthorized access returns 401 or 403","Malformed answer value for the given record type may return 422"],"whenToPreferThis":"Use this endpoint when you need to fully replace an existing DNS record's values (type, host, answer, TTL, priority). Always fetch the current record first to preserve fields you don't intend to change, since this is a full replacement operation. Prefer this over create when the record already exists and only needs updating.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-06T12:33:03.261Z","isFirstParty":false,"canonicalSlug":"domains-rapidruntime-com-update-a-dns-record-full-replacement-ad4e8648"}