Namefi Domain Config API
The domain-config API from Namefi — 1 operation(s) for domain-config.
The domain-config API from Namefi — 1 operation(s) for domain-config.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/namefi-io:namefi-io-domain-config-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Namefi Domain Config API
version: next
servers:
- url: /v-next/
security:
- apiKeyAuth: []
- bearerAuth: []
tags:
- name: domain-config
paths:
/domain-config/auto-renew:
put:
operationId: toggleAutoRenew
summary: Toggle domain auto-renewal
description: Enable or disable automatic renewal for a domain. When enabled, the domain will be renewed automatically before expiration using the available payment methods on the owner wallet.
tags:
- domain-config
requestBody:
required: true
content:
application/json:
schema:
anyOf:
- type: object
properties:
payloadType:
const: ToggleAutoRenew
payload:
type: object
properties:
normalizedDomainName:
type: string
maxLength: 255
pattern: ^[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?(\.[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?)*$
enableAutoRenew:
type: boolean
required:
- normalizedDomainName
- enableAutoRenew
description: ToggleAutoRenew
timestamp:
type: number
nonce:
type: string
required:
- payloadType
- payload
- timestamp
- nonce
description: ToggleAutoRenewEip712Envelope
- type: object
properties:
normalizedDomainName:
type: string
maxLength: 255
pattern: ^[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?(\.[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?)*$
enableAutoRenew:
type: boolean
required:
- normalizedDomainName
- enableAutoRenew
description: ToggleAutoRenew
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
required:
- success
'400':
description: '400'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: BAD_REQUEST
status:
const: 400
message:
type: string
default: Bad Request
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'401':
description: '401'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: UNAUTHORIZED
status:
const: 401
message:
type: string
default: Unauthorized
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'402':
description: '402'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: PAYMENT_REQUIRED
status:
const: 402
message:
type: string
default: Payment Required
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'403':
description: '403'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: FORBIDDEN
status:
const: 403
message:
type: string
default: Forbidden
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'404':
description: '404'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: NOT_FOUND
status:
const: 404
message:
type: string
default: Not Found
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'406':
description: '406'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: NOT_ACCEPTABLE
status:
const: 406
message:
type: string
default: Not Acceptable
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'408':
description: '408'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: TIMEOUT
status:
const: 408
message:
type: string
default: Request Timeout
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'409':
description: '409'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: CONFLICT
status:
const: 409
message:
type: string
default: Conflict
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'412':
description: '412'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: PRECONDITION_FAILED
status:
const: 412
message:
type: string
default: Precondition Failed
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'429':
description: '429'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: TOO_MANY_REQUESTS
status:
const: 429
message:
type: string
default: Too Many Requests
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'500':
description: '500'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: INTERNAL_SERVER_ERROR
status:
const: 500
message:
type: string
default: Internal Server Error
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
x-eip712-accepted-primary-types:
- ToggleAutoRenewEnvelope
x-eip712-types:
ToggleAutoRenew:
- name: normalizedDomainName
type: string
- name: enableAutoRenew
type: bool
ToggleAutoRenewEnvelope:
- name: payloadType
type: string
- name: payload
type: ToggleAutoRenew
- name: timestamp
type: uint256
- name: nonce
type: string
parameters:
- $ref: '#/components/parameters/Eip7702AccountHeader'
- $ref: '#/components/parameters/Eip1271AccountHeader'
- $ref: '#/components/parameters/Erc1271AccountHeader'
x-badges:
- name: EIP712
color: '#b5f5ce'
get:
operationId: getAutoRenew
summary: Get domain auto-renewal status
description: Check whether automatic renewal is enabled for a domain. Requires domain ownership.
tags:
- domain-config
parameters:
- name: normalizedDomainName
in: query
required: true
schema:
type: string
maxLength: 255
pattern: ^[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?(\.[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?)*$
allowEmptyValue: true
allowReserved: true
- name: organizationId
in: query
required: false
schema:
type: string
format: uuid
allowEmptyValue: true
allowReserved: true
- $ref: '#/components/parameters/Eip7702AccountHeader'
- $ref: '#/components/parameters/Eip1271AccountHeader'
- $ref: '#/components/parameters/Erc1271AccountHeader'
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
autoRenewEnabled:
type: boolean
required:
- autoRenewEnabled
'400':
description: '400'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: BAD_REQUEST
status:
const: 400
message:
type: string
default: Bad Request
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'401':
description: '401'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: UNAUTHORIZED
status:
const: 401
message:
type: string
default: Unauthorized
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'402':
description: '402'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: PAYMENT_REQUIRED
status:
const: 402
message:
type: string
default: Payment Required
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'403':
description: '403'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: FORBIDDEN
status:
const: 403
message:
type: string
default: Forbidden
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'404':
description: '404'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: NOT_FOUND
status:
const: 404
message:
type: string
default: Not Found
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'406':
description: '406'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: NOT_ACCEPTABLE
status:
const: 406
message:
type: string
default: Not Acceptable
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'408':
description: '408'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: TIMEOUT
status:
const: 408
message:
type: string
default: Request Timeout
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'409':
description: '409'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: CONFLICT
status:
const: 409
message:
type: string
default: Conflict
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'412':
description: '412'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: PRECONDITION_FAILED
status:
const: 412
message:
type: string
default: Precondition Failed
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'429':
description: '429'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: TOO_MANY_REQUESTS
status:
const: 429
message:
type: string
default: Too Many Requests
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
'500':
description: '500'
content:
application/json:
schema:
oneOf:
- type: object
properties:
defined:
const: true
code:
const: INTERNAL_SERVER_ERROR
status:
const: 500
message:
type: string
default: Internal Server Error
data: {}
required:
- defined
- code
- status
- message
- type: object
properties:
defined:
const: false
code:
type: string
status:
type: number
message:
type: string
data: {}
required:
- defined
- code
- status
- message
components:
parameters:
Eip1271AccountHeader:
name: x-namefi-eip1271-account
in: header
required: false
schema:
type: string
description: Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.
Eip7702AccountHeader:
name: x-namefi-eip7702-account
in: header
required: false
schema:
type: string
description: Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.
Erc1271AccountHeader:
name: x-namefi-erc1271-account
in: header
required: false
schema:
type: string
description: Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.
securitySchemes:
apiKeyAuth:
type: apiKey
name: x-api-key
in: header
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT