---
title: "Read every nickname/directives the caller has set, across all agents"
method: GET
path: "/api/v1/agent_preferences"
tags: ["Agents"]
---

# Read every nickname/directives the caller has set, across all agents

`GET /api/v1/agent_preferences`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/agent_preferences`
- Auth: API key in header `api-key`

Keyed by agent id. An agent with no nickname, directives or character from this caller never appears -- an empty AgentPreference row is never stored.

## Response `200`

OK.

- object
  - `preferences` object: Keyed by agent id (a uuid string).

## Other responses

- `401`: Missing or invalid credentials.

---

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