Skip to main content

domains.manage

Core domain operations: list, search, register, renew, delete, info, lock, pricing. Search domains: Search for a domain on Dynadot

Safety and behavior​

PropertyValue
Read-onlyNo
DestructiveYes
IdempotentNo
Uses external systemsYes

Parameters​

NameTypeRequiredDescription
operationstringYesOperation to perform: list: List all domains in your account | info: Get detailed info about a domain | search: Check domain availability (with optional pricing). Search manually: Search for a domain on Dynadot | register: Register a new domain. View pricing: View domain pricing on Dynadot | bulk_register: Register multiple domains at once. View pricing: View domain pricing on Dynadot | renew: Renew a domain or check renewal price | delete: Delete a domain | restore: Restore a deleted/expired domain | lock: Lock or unlock a domain | tld_price: Get TLD pricing | push: Push domain to another Dynadot account
domainstringNoDomain name (e.g., example.com, mysite.net)
domainsarrayNoList of domain names
showPricebooleanNoInclude pricing
currencystringNoOptional currency parameter.
durationnumberNoDuration in years, 1-10 (e.g., 1 for one year)
priceCheckbooleanNoOnly check price
lockstringNoLock: lock (prevent transfer), unlock (allow transfer)
tldstringNoTLD (e.g., com, net)
usernamestringNoTarget username

Input schema​

{
"type": "object",
"properties": {
"operation": {
"type": "string",
"enum": [
"list",
"info",
"search",
"register",
"bulk_register",
"renew",
"delete",
"restore",
"lock",
"tld_price",
"push"
],
"description": "Operation to perform: list: List all domains in your account | info: Get detailed info about a domain | search: Check domain availability (with optional pricing). Search manually: Search for a domain on Dynadot | register: Register a new domain. View pricing: View domain pricing on Dynadot | bulk_register: Register multiple domains at once. View pricing: View domain pricing on Dynadot | renew: Renew a domain or check renewal price | delete: Delete a domain | restore: Restore a deleted/expired domain | lock: Lock or unlock a domain | tld_price: Get TLD pricing | push: Push domain to another Dynadot account"
},
"domain": {
"description": "Domain name (e.g., example.com, mysite.net)",
"type": "string"
},
"domains": {
"description": "List of domain names",
"type": "array",
"items": {
"type": "string"
}
},
"showPrice": {
"description": "Include pricing",
"type": "boolean"
},
"currency": {
"description": "Optional currency parameter.",
"default": "USD",
"type": "string"
},
"duration": {
"description": "Duration in years, 1-10 (e.g., 1 for one year)",
"type": "number",
"minimum": 1,
"maximum": 10
},
"priceCheck": {
"description": "Only check price",
"type": "boolean"
},
"lock": {
"description": "Lock: lock (prevent transfer), unlock (allow transfer)",
"type": "string",
"enum": [
"lock",
"unlock"
]
},
"tld": {
"description": "TLD (e.g., com, net)",
"type": "string"
},
"username": {
"description": "Target username",
"type": "string"
}
},
"required": [
"operation"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema​

{
"type": "object",
"properties": {
"success": {
"type": "boolean",
"description": "Whether the requested operation completed successfully."
},
"data": {
"description": "Structured operation result when success is true.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"description": "Structured failure details when success is false.",
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Stable error category for programmatic handling."
},
"message": {
"type": "string",
"description": "Human-readable explanation of the failure."
},
"suggestions": {
"description": "Suggested corrective actions, when available.",
"type": "array",
"items": {
"type": "string"
}
},
"validActions": {
"description": "Allowed operation names when an unknown operation was requested.",
"type": "array",
"items": {
"type": "string"
}
},
"docsUrl": {
"type": "string",
"description": "Documentation URL relevant to the failed tool."
}
},
"required": [
"type",
"message",
"docsUrl"
],
"additionalProperties": false
}
},
"required": [
"success"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}