---
title: "Update an agent identity"
method: PATCH
path: "/api/agents/identity/{slug}"
tags: ["Domains"]
---

# Update an agent identity

`PATCH /api/agents/identity/{slug}`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/agents/identity/{slug}`
- Auth: HTTP bearer

Update a free identity's name/bio/emoji/email/links. Requires `account:write`.

## Path parameters

- `slug` string, required

## Request body

- object
  - `name` string
  - `bio` string
  - `emoji` string
  - `email` string
  - `links` object[]
    - `label` string
    - `url` string

## Response `200`

Updated

- AgentIdentity: A free agent identity served at <slug>.domani.run.
  - `id` string, required: Stable identity id used to bind scoped API tokens
  - `slug` string, required
  - `url` string, required: The identity subdomain (canonical)
  - `page_url` string, required: Path fallback that always works
  - `name` string, nullable, required
  - `bio` string, nullable, required
  - `emoji` string, nullable, required
  - `email` string, nullable, required
  - `links` object[], required
    - `label` string
    - `url` string
  - `views` integer, required
  - `created_at` string, date-time, required

## Other responses

- `401`: Missing or invalid API key
- `404`: Identity not found
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)