v1

latestOpenAPI 3.0.0Cognigy Proprietary License2026-07-2239524.1 MB

Personas

Create scenario from transcript

Create a scenario draft by analyzing a conversation transcript. The system uses LLM to extract user intent, conversation goals, and user characteristics from the transcript, then generates an appropriate persona package.

The endpoint supports:

Fetching transcript via sessionId from analytics service (RPC call)
Direct transcript content via transcriptContent
Optional flow context for enhanced persona generation
Content safety validation (warnings only, non-blocking)

Priority: If both sessionId and transcriptContent are provided, sessionId takes precedence.

Returns a complete persona package and metadata about the analysis.

post/personas/from-transcript

Query parameters

projectIdstring

Project identifier (alternative to projectReference in body)

Request body

projectReferencestring

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

sessionIdstring

Session identifier to retrieve transcript from analytics service. If provided, takes precedence over transcriptContent.

flowIdstring

Optional: Flow ID to associate with and extract agent context for enhanced generation

numberOfSuccessCriteriainteger

Optional: Number of success criteria to generate (default: 5, min: 1, max: 10)

Response

Scenario created successfully from transcript

successboolean required

Whether the generation was successful