---
title: "Set this agent's own display name"
method: PATCH
path: "/v1/me/agent"
tags: ["Account"]
---

# Set this agent's own display name

`PATCH /v1/me/agent`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/me/agent`
- Auth: `bearerAuth` (a scheme the document does not define)

Changes only the authenticated API key's display nickname. It does not rename the key, change its permissions, or affect another agent. The account owner can lock the display name in Agent Control. Pass null to return to the key's original name.

## Request body

- object
  - `nickname` string, nullable, required

## Response `200`

Updated identity

- object
  - `id` string, required
  - `name` string, required
  - `clientName` string, required
  - `nickname` string, nullable, required
  - `nicknameLocked` boolean, required

## Other responses

- `403`: The account owner locked this display name

---

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