---
title: "Generate persona packages"
method: POST
path: "/personas/generate"
tags: ["Personas"]
---

# Generate persona packages

`POST /personas/generate`

Generate persona packages based on selected mission type and persona type with auto-discovery of AI agents and tools from the flow.
This endpoint creates complete persona packages including scenario names, persona descriptions, missions, and success criteria.

## Query parameters

- `projectId` string

## Request body

- object
  - `projectReference` string — Project reference for context identification (alternative to projectId query parameter)
  - `flowReferenceId` string, required — Flow reference ID for AI agent and tool discovery
  - `jobNodeId` string — Optional: Target specific job node for precise tool discovery
  - `selectedMissionType` object, required — Selected mission type with success criteria
    - `name` string, required — Mission type name
    - `description` string, required — Mission type description
    - `successCriteria` object[], required — Success criteria for this mission type
      - `name` string, required — Success criterion name
      - `description` string, required — Success criterion description
  - `selectedPersonaType` object, required — Selected persona type with characteristics
    - `name` string, required — Persona type name
    - `description` string, required — Persona type description and characteristics
  - `numberOfSuccessCriteria` integer, required — Number of success criteria to generate per persona package
  - `requestedPackages` integer, required — Number of persona packages to generate

## Response `200`

Persona packages generated successfully

- object
  - `success` boolean, required — Whether the generation was successful
  - `personaPackages` object[], required — Array of generated persona packages
    - `simulationName` string, required — Generated scenario name
    - `personaName` string, required — Generated persona name
    - `personaDescription` string, required — Generated persona description
    - `mission` string, required — Generated mission
    - `successCriteria` object[], required — Generated success criteria
      - `type` string, required — Success criterion type
      - `params` object, required — Success criterion parameters
  - `metadata` object — Optional metadata about the generation
    - `requestId` string — Request identifier
    - `processedAt` string — Timestamp when processed
    - `model` string — LLM model used

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing authentication
- `403` — Forbidden - Insufficient permissions
- `500` — Internal Server Error - Server error

---

[API](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference.md) · [All operations](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cognigy/simulator-openapi-rest-ful-api-reference/revisions/85b2872bdfb7/schema)