---
title: "List the public persona catalog."
method: GET
path: "/personas"
tags: ["Catalog"]
---

# List the public persona catalog.

`GET /personas`

## Request

- Base URL: `https://agentspodium.com/api`
- URL: `https://agentspodium.com/api/personas`
- Auth: none required

Call before creating an agent to choose a `personaId` — built-in personas plus any published community ones. No auth required; browse freely.

## Response `200`

OK.

- object
  - `personas` Persona[], required
    - `id` string, required
    - `icon` string, required
    - `name` string, required
    - `tagline` string, required
    - `forWho` string, required
    - `does` string[], required
    - `doesExamples` object: One example question per `does` label, keyed by that label.
    - `skills` string[], required
    - `channels` string[], required
    - `category` 'study' | 'creative' | 'gaming' | 'career' | 'life' | 'social' | 'tech' | 'fun', required
    - `tags` string[], required
    - `tier` 'tiny' | 'small' | 'medium' | 'large', required: Recommended minimum plan for this persona.
    - `spec` string, required
    - `price` string, required
    - `risk` 'low' | 'high', required
    - `disclaimer` string, nullable, required
    - `demo` DemoLine[]: Scripted, illustrative conversation. Absent when none was written.
      - `role` 'user' | 'agent', required
      - `text` string, required
    - `ru` PersonaL10n
      - `name` string, required
      - `tagline` string, required
      - `forWho` string, required
      - `does` string[], required
      - `disclaimer` string, nullable
      - `doesExamples` object
      - `demo` DemoLine[]
        - `role` 'user' | 'agent', required
        - `text` string, required
    - `es` PersonaL10n
      - `name` string, required
      - `tagline` string, required
      - `forWho` string, required
      - `does` string[], required
      - `disclaimer` string, nullable
      - `doesExamples` object
      - `demo` DemoLine[]
        - `role` 'user' | 'agent', required
        - `text` string, required
    - `pt` PersonaL10n
      - `name` string, required
      - `tagline` string, required
      - `forWho` string, required
      - `does` string[], required
      - `disclaimer` string, nullable
      - `doesExamples` object
      - `demo` DemoLine[]
        - `role` 'user' | 'agent', required
        - `text` string, required
    - `tr` PersonaL10n
      - `name` string, required
      - `tagline` string, required
      - `forWho` string, required
      - `does` string[], required
      - `disclaimer` string, nullable
      - `doesExamples` object
      - `demo` DemoLine[]
        - `role` 'user' | 'agent', required
        - `text` string, required
    - `ind` PersonaL10n
      - `name` string, required
      - `tagline` string, required
      - `forWho` string, required
      - `does` string[], required
      - `disclaimer` string, nullable
      - `doesExamples` object
      - `demo` DemoLine[]
        - `role` 'user' | 'agent', required
        - `text` string, required
    - `authorId` string: Present for user-created (community) personas.
    - `author` string
    - `status` 'builtin' | 'draft' | 'published'
    - `soul` string: The persona's system prompt.
    - `deployedCount` integer
    - `recommendedModels` string[]

---

[API](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset.md) · [All operations](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/llms.txt) · [OpenAPI document](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/revisions/46b0fc821822?raw)