---
title: "Set an AI Agent's visibility (v2)"
method: POST
path: "/v2/agents/{idOrAddress}/visibility"
tags: ["Agents"]
---

# Set an AI Agent's visibility (v2)

`POST /v2/agents/{idOrAddress}/visibility`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/agents/{idOrAddress}/visibility`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

`private`: only the owner sees and uses it. `unlisted`: anyone with
the id or address can read, clone, try and invite it, but it is not
listed. `public`: also listed for every account.

Owner, or a platform admin with `isSuperAdmin.write` (for moderation).
Supports `User JWT` and `B2B Server JWT`.

## Path parameters

- `idOrAddress` string, required

## Request body

- object
  - `visibility` 'private' | 'unlisted' | 'public', required

## Response `200`

```
{ ok: true, agent: Agent }
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: ``` { error: 'Forbidden', code: 'FORBIDDEN' } ```
- `404`: ``` { error: 'Agent not found', code: 'AGENT_NOT_FOUND' } ```
- `422`: ``` { error: string, code: 'VALIDATION_ERROR' } ```
- `500`: Internal Server Error

---

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