Skip to main content

PersonaListResponse

limit object

Absent in summary mode.

anyOf
integer
offset object
anyOf
integer
personas object[]required
  • Array [
    • avatar_sourceAvatar Source
    Default value:
    avatar_urlAvatar Url
    Default value:
    categoryCategoryrequired

    Audience category the persona belongs to.

    Example: investors
    communication_styleCommunication Style
    Default value:
    concernsConcerns
    Default value:
    created_atCreated Atrequired
    Example: 2026-09-29T16:40:12+00:00
    created_byCreated By
    Default value: system
    default_voice_profile_id object
    anyOf
    string
    description object
    anyOf
    string
    entity_kindEntity Kind

    person, organization, segment or empty when not set.

    Default value:
    entity_kind_resolvedEntity Kind Resolved
    Default value:
    external_sourcesobject[]
    grounded_statementsobject[]

    Statements the persona is grounded on, with their sources.

    health_state object
    property name*any
    idIdrequired
    Example: d4e9b2a1-6c3f-4b8e-9f21-0a7c5e3d1b60
    include_in_audienceInclude In Audience

    Whether the persona takes part in audience-wide reactions.

    Default value: true
    include_in_voice_listInclude In Voice List

    Whether the persona is offered as a writing voice.

    Default value: false
    instructionsInstructions

    How the persona should behave when it reacts.

    Default value:
    interestsInterests
    Default value:
    is_activeIs Active
    Default value: true
    is_linked_to_sourceIs Linked To Source
    Default value: false
    is_marketplace_managed object
    anyOf
    boolean
    labelsstring[]
    linked_knowledgebase_idsstring[]
    nameNamerequired
    Example: Skeptical CFO
    refresh_policy object
    property name*any
    response_languageResponse Language

    BCP-47 language the persona answers in; empty inherits the workspace market language.

    Default value:
    social_links object[]
  • Array [
    • platformPlatformrequired
    Example: linkedin
    urlUrlrequired
    Example: https://www.linkedin.com/in/example
    property name*any
  • ]
    • source_persona_id object

    Marketplace persona this one is linked to, if any.

    anyOf
    string
    templateTemplate

    The persona's system prompt.

    Default value:
    toneTone
    Default value:
    updated_atUpdated Atrequired
    Example: 2026-10-05T09:12:44+00:00
    versionVersion
    Default value: 1
    voice_profilesobject[]
    voice_visibilityVoice Visibility

    workspace or private.

    Default value: workspace
    workspace_idWorkspace Idrequired
    writing_sample_document_idsstring[]
    property name*any
  • ]
    • totalTotalrequired

    Personas matching the filters, before limit/offset.

    property name*any
    PersonaListResponse
    {
      "limit": 0,
      "offset": 0,
      "personas": [
        {
          "avatar_source": "",
          "avatar_url": "",
          "category": "investors",
          "communication_style": "",
          "concerns": "",
          "created_at": "2026-09-29T16:40:12+00:00",
          "created_by": "system",
          "default_voice_profile_id": "string",
          "description": "Runs finance at a mid-cap industrial; distrusts growth narratives without unit economics.",
          "entity_kind": "",
          "entity_kind_resolved": "",
          "external_sources": [
            {}
          ],
          "grounded_statements": [
            {}
          ],
          "health_state": {},
          "id": "d4e9b2a1-6c3f-4b8e-9f21-0a7c5e3d1b60",
          "include_in_audience": true,
          "include_in_voice_list": false,
          "instructions": "",
          "interests": "",
          "is_active": true,
          "is_linked_to_source": false,
          "is_marketplace_managed": true,
          "labels": [
            "string"
          ],
          "linked_knowledgebase_ids": [
            "string"
          ],
          "name": "Skeptical CFO",
          "refresh_policy": {},
          "response_language": "",
          "social_links": [
            {
              "platform": "linkedin",
              "url": "https://www.linkedin.com/in/example"
            }
          ],
          "source_persona_id": "string",
          "template": "",
          "tone": "",
          "updated_at": "2026-10-05T09:12:44+00:00",
          "version": 1,
          "voice_profiles": [
            {}
          ],
          "voice_visibility": "workspace",
          "workspace_id": "string",
          "writing_sample_document_ids": [
            "string"
          ]
        }
      ],
      "total": 0
    }