Skip to main content

PersonaCreateRequest

avatar_prompt object
anyOf
string
avatar_source object
anyOf
string
avatar_url object

http(s) image URL or a data:image base64 URL.

anyOf
string
categoryCategory

Audience category; see GET /api/v1/personas/categories.

Default value: general
Example: investors
communication_styleCommunication Style
Default value:
concernsConcerns
Default value:
descriptionDescription

Who this persona is, in a sentence or two.

Default value:
Example: Runs finance at a mid-cap industrial; distrusts growth narratives without unit economics.
entity_kind object

person, organization or segment.

anyOf
string
external_sources object
anyOf
  • Array [
    • property name*any
  • ]
    • include_in_audienceInclude In Audience
    Default value: true
    include_in_voice_listInclude In Voice List
    Default value: false
    instructionsInstructions

    Behavioural instructions used when the persona reacts.

    Default value:
    interestsInterests
    Default value:
    is_activeIs Active
    Default value: true
    nameNamerequired

    Display name.

    Example: Skeptical CFO
    response_language object

    BCP-47 language tag the persona answers in; omit to inherit the workspace market language.

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

    Marketplace persona to link this one to.

    anyOf
    string
    templateTemplate

    A full system prompt; leave empty to let Kumkuat build one from the fields below.

    Default value:
    toneTone
    Default value:
    voice_visibility object

    workspace (default) or private.

    anyOf
    string
    writing_sample_document_ids object

    Workspace document ids whose text defines the persona's writing voice.

    anyOf
  • Array [
    • string
  • ]
    • property name*any
    PersonaCreateRequest
    {
      "avatar_prompt": "string",
      "avatar_source": "string",
      "avatar_url": "string",
      "category": "investors",
      "communication_style": "",
      "concerns": "",
      "description": "Runs finance at a mid-cap industrial; distrusts growth narratives without unit economics.",
      "entity_kind": "string",
      "external_sources": [
        {}
      ],
      "include_in_audience": true,
      "include_in_voice_list": false,
      "instructions": "",
      "interests": "",
      "is_active": true,
      "name": "Skeptical CFO",
      "response_language": "en",
      "social_links": [
        {
          "platform": "linkedin",
          "url": "https://www.linkedin.com/in/example"
        }
      ],
      "source_persona_id": "string",
      "template": "",
      "tone": "",
      "voice_visibility": "string",
      "writing_sample_document_ids": [
        "string"
      ]
    }