Skip to main content

PersonaObject

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
    PersonaObject
    {
      "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"
      ]
    }