Create User Domain | Agentverse Documentation

Create a new domain registration. Validates the domain name and checks for conflicts before creating a PENDING registration. The domain will be processed by a background worker which will attempt to register it on the smart contract. Optionally, an agent address can be provided to associate the domain with an agent immediately. Maximum one domain per agent is allowed.

Request

This endpoint expects an object.

domain_namestringRequired

agent_recordslist of objectsOptional

Response

Successful Response

namestring

statusenum

assigned_agentslist of objects

expirystring or nullformat: "date-time"

1	import requests
2
3	url = "https://agentverse.ai/v2/users/domains"
4
5	payload = { "domain_name": "foo" }
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	print(response.json())

1	{
2	"name": "foo",
3	"status": "Registered",
4	"assigned_agents": [
5	{
6	"address": "foo",
7	"weight": 1
8	}
9	],
10	"expiry": "foo"
11	}

Request

Response

Errors