Skip to main content
POST
/
v1
/
persona
JavaScript
import Roark from '@roarkanalytics/sdk';

const client = new Roark({
  bearerToken: 'My Bearer Token',
});

const persona = await client.persona.create({ accent: 'US', gender: 'MALE', language: 'EN', name: 'name' });

console.log(persona.data);
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "language": "EN",
    "secondaryLanguage": "EN",
    "accent": "US",
    "gender": "MALE",
    "backgroundNoise": "NONE",
    "speechPace": "NORMAL",
    "speechClarity": "CLEAR",
    "hasDisfluencies": false,
    "baseEmotion": "NEUTRAL",
    "intentClarity": "CLEAR",
    "confirmationStyle": "EXPLICIT",
    "memoryReliability": "HIGH",
    "backstoryPrompt": "A busy professional calling during lunch break",
    "properties": {
      "age": 35,
      "zipCode": "94105",
      "occupation": "Software Engineer"
    },
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Input for creating a new persona

​
name
string
required

The name the agent will identify as during conversations

​
language
enum<string>
required

Primary language ISO 639-1 code for the persona

Available options:
EN,
ES,
DE,
HI,
FR,
NL,
AR,
EL
​
accent
enum<string>
required

Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with optional variants

Available options:
US,
US_X_SOUTH,
GB,
ES,
DE,
IN,
FR,
NL,
SA,
GR,
AU
​
gender
enum<string>
required

Gender of the persona

Available options:
MALE,
FEMALE,
NEUTRAL
​
secondaryLanguage
enum<string> | null

Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)

Available options:
EN
​
backgroundNoise
enum<string>
default:NONE

Background noise setting

Available options:
NONE,
AIRPORT,
CHILDREN_PLAYING,
CITY,
COFFEE_SHOP,
DRIVING,
OFFICE,
THUNDERSTORM
​
speechPace
enum<string>
default:NORMAL

Speech pace of the persona

Available options:
SLOW,
NORMAL,
FAST
​
speechClarity
enum<string>
default:CLEAR

Speech clarity of the persona

Available options:
CLEAR,
VAGUE,
RAMBLING
​
hasDisfluencies
boolean
default:false

Whether the persona uses filler words like "um" and "uh"

​
baseEmotion
enum<string>
default:NEUTRAL

Base emotional state of the persona

Available options:
NEUTRAL,
CHEERFUL,
CONFUSED,
FRUSTRATED,
SKEPTICAL,
RUSHED
​
intentClarity
enum<string>
default:CLEAR

How clearly the persona expresses their intentions

Available options:
CLEAR,
INDIRECT,
VAGUE
​
confirmationStyle
enum<string>
default:EXPLICIT

How the persona confirms information

Available options:
EXPLICIT,
VAGUE
​
memoryReliability
enum<string>
default:HIGH

How reliable the persona's memory is

Available options:
HIGH,
LOW
​
backstoryPrompt
string | null

Background story and behavioral patterns for the persona

Example:

"A busy professional calling during lunch break"

​
properties
object

Additional custom properties about the persona

Example:
{
  "age": 35,
  "zipCode": "94105",
  "occupation": "Software Engineer"
}

Response

The created persona

​
data
object
required