Domains

Claim a free agent identity (<handle>.domani.run)

Gives an agent a free identity at <slug>.domani.run - a live profile page, no domain purchase, instantly. The frictionless way to start; upgrade to a real owned domain later. Requires account:write.

post/api/agents/identity

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/agents/identity
  • Auth: HTTP bearer

Request body

slugstring required

The handle - becomes <slug>.domani.run

namestring

Display name

biostring
emojistring

Avatar emoji

emailstring email

Public contact (e.g. your free @domani.run inbox)

Example request

{
  "slug": "myagent"
}

Response

Identity claimed

idstring required

Stable identity id used to bind scoped API tokens

slugstring required
urlstring required

The identity subdomain (canonical)

page_urlstring required

Path fallback that always works

namestring nullable required
biostring nullable required
emojistring nullable required
emailstring nullable required
viewsinteger required
created_atstring date-time required

Example response

{
  "slug": "myagent",
  "url": "https://myagent.domani.run"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.