Skip to main content
POST
/
personas
/
generate-bulk
Bulk generate separated personas and missions
curl --request POST \
  --url https://api-trial.cognigy.ai/testing/personas/generate-bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "flowReferenceId": "<string>",
  "allMissionTypes": [
    {
      "name": "<string>",
      "description": "<string>",
      "successCriteria": [
        {
          "name": "<string>",
          "description": "<string>"
        }
      ]
    }
  ],
  "allPersonaTypes": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "numberOfSuccessCriteria": 2,
  "requestedPackages": 2,
  "projectReference": "<string>"
}
'
{
  "success": true,
  "personas": {
    "Customer Support Agent": [
      {
        "simulationName": "Customer Issue Resolution",
        "personaName": "Sarah",
        "personaDescription": "Experienced support agent..."
      }
    ]
  },
  "missions": {
    "Technical Support": [
      {
        "mission": "Resolve customer technical issue",
        "successCriteria": [
          {
            "type": "goal",
            "params": {
              "description": "Issue resolved"
            }
          }
        ]
      }
    ]
  },
  "metadata": {
    "requestId": "<string>",
    "processedAt": "<string>",
    "model": "<string>",
    "personaTypesCount": 123,
    "missionTypesCount": 123
  }
}

Authorizations

Authorization
string
header
required

JWT Bearer Token for authentication

Query Parameters

projectId
string

Project identifier (alternative to projectReference in body)

Body

application/json
flowReferenceId
string
required

Flow reference ID for AI agent and tool discovery

allMissionTypes
object[]
required

All mission types to generate missions for

allPersonaTypes
object[]
required

All persona types to generate personas for

numberOfSuccessCriteria
integer
required

Number of success criteria to generate per mission

Required range: x >= 1
requestedPackages
integer
required

Number of packages to generate per type combination

Required range: x >= 1
projectReference
string

Project reference for context identification (alternative to projectId query parameter)

Response

Bulk personas and missions generated successfully

success
boolean
required

Whether the generation was successful

personas
object
required

Personas organized by persona type name as keys

Example:
{
"Customer Support Agent": [
{
"simulationName": "Customer Issue Resolution",
"personaName": "Sarah",
"personaDescription": "Experienced support agent..."
}
]
}
missions
object
required

Missions organized by mission type name as keys

Example:
{
"Technical Support": [
{
"mission": "Resolve customer technical issue",
"successCriteria": [
{
"type": "goal",
"params": { "description": "Issue resolved" }
}
]
}
]
}
metadata
object

Optional metadata about the generation

Last modified on July 2, 2026