---
title: "Get persona options (mission types and persona types)"
method: POST
path: "/personas/options"
tags: ["Personas"]
---

# Get persona options (mission types and persona types)

`POST /personas/options`

Smart endpoint that handles multiple scenarios for getting persona options:
- **Legacy**: Provide only `flowId` to analyze the entire flow
- **AI Agent Specific**: Provide `flowId` + `aiagentReferenceId` to analyze a specific AI agent
- **Job Node Specific**: Provide `flowId` + `aiagentReferenceId` + `jobNodeId` to analyze a specific job node

## Query parameters

- `projectId` string, required

## Request body

- object
  - `flowId` string, required — Flow identifier (required for all scenarios)
  - `aiagentReferenceId` string — AI Agent reference ID (optional - for AI agent specific analysis)
  - `jobNodeId` string — Job Node ID (optional - requires aiagentReferenceId, for job node specific analysis)

## Response `200`

Persona options retrieved successfully

- object
  - `simulationName` string, required — Suggested name for the scenario based on the flow/agent context
  - `missionTypes` object[], required — Available mission types with success criteria
    - `name` string, required — Name of the mission type
    - `description` string, required — Description of the mission
    - `successCriteria` object[], required — Success criteria for this mission
      - `name` string, required — Name of the success criterion
      - `description` string, required — Description of the success criterion
  - `personaTypes` object[], required — Available persona types with behavioral characteristics
    - `name` string, required — Name of the persona type
    - `description` string, required — Description and behavioral characteristics of the persona

## 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)