Create or update custom subname data

PUT /v1/subname/data

This allows creating user defined data object to be created and stored for the provided subname.

In order to set a data record, send a request to /subname/data/{label}/{domain}/{key}:

• label subname

• domain second-level domain name

• key data record key

The following data payload is required to set the data object:

{ "data": data_object_to_be_stored }

If the object under the specified key already exists, the object will be updated. Otherwise, a new object for the key gets created.

put

/v1/subname/data/{label}//{domain}//{key}

Path parameters

labelstringrequired

The subname label

Example: ninja

domainstringrequired

The parent ENS domain name

Example: thenamespace.eth

keystringrequired

Data record key.

Example: profile-image

Header parameters

Authorization Bearer tokenAuthorization: Bearer <_your_api_key_>

API key needed to access the endpoint

Body

dataobjectrequired

Data to be stored under the provided key.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '/v1/subname/data/{label}/{domain}/{key}' \
  --header 'Content-Type: application/json' \
  --data '{"data":{}}'

200

400

401

500

200

No body

Data record successfully added.