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

label*string

The subname label

Example: "ninja"

domain*string

The parent ENS domain name

Example: "thenamespace.eth"

key*string

Data record key.

Example: "profile-image"

Header parameters

Body

application/json

data*object

Data to be stored under the provided key.

Response

200400401500

Data record successfully added.

Request

JavaScriptCurlPython

const response = await fetch('/v1/subname/data/{label}/{domain}/{key}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

400500

{
  "status": 400,
  "path": "text",
  "error": [
    {
      "property": "text",
      "value": "text",
      "message": "text"
    }
  ]
}