> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Regenerate a specific field of a persona package

> Regenerate a specific field of a persona package using LLM. Requires the full persona package context to regenerate any individual field.
Valid fields to regenerate: simulationName, personaName, personaDescription, mission, successCriteria




## OpenAPI

````yaml https://api-trial.cognigy.ai/testing/openapi/openapi-viewer.json post /personas/regenerate-field
openapi: 3.0.0
info:
  title: SIMULATOR OPENAPI REST-ful-API Reference
  version: 2025.20.0
  description: >

    ### Introduction

    This is the [OpenAPI 3.0](https://swagger.io/specification/) documentation

    of the
    [REST](https://en.wikipedia.org/wiki/Representational_state_transfer)-ful
    SIMULATOR OPENAPI API.


    ### Cross-Origin Resource Sharing

    This API features Cross-Origin Resource Sharing (CORS) implemented in

    compliance with [W3C spec](https://www.w3.org/TR/cors/), which allows

    cross-domain communication from the browser. All responses have a wildcard

    same-origin header which makes the API completely accessible.


    ### Authentication

    SIMULATOR OPENAPI offers following forms of authentication:

    - Bearer Token (JWT)

    - API Key


    ### Error Handling

    This API uses HTTP status codes equal or above 400 to indicate errors. Error

    details are generated in compliance with [RFC 7807 - "Problem Details for
    HTTP APIs"](https://tools.ietf.org/html/rfc7807).


    Every error response contains a traceId, which should be provided to the
    SIMULATOR OPENAPI Technical Support when reporting an error.
  contact:
    name: Cognigy Technical Support
    url: https://www.cognigy.com
    email: support@cognigy.com
  license:
    name: Cognigy Proprietary License
servers:
  - url: https://api-trial.cognigy.ai/testing
    description: Cognigy Service Testing API
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: Simulations
    description: >-
      Simulation management operations - Create, read, update, and delete
      simulations
externalDocs:
  description: SIMULATOR OPENAPI Documentation
  url: https://docs.cognigy.com/docs/service-testing/
paths:
  /personas/regenerate-field:
    post:
      tags:
        - Personas
      summary: Regenerate a specific field of a persona package
      description: >
        Regenerate a specific field of a persona package using LLM. Requires the
        full persona package context to regenerate any individual field.

        Valid fields to regenerate: simulationName, personaName,
        personaDescription, mission, successCriteria
      operationId: regeneratePersonaField
      parameters:
        - name: projectId
          in: query
          required: true
          schema:
            type: string
          description: Project identifier
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                projectReference:
                  type: string
                  description: >-
                    Project reference for context identification (alternative to
                    projectId query parameter)
                fieldToRegenerate:
                  type: string
                  enum:
                    - simulationName
                    - personaName
                    - personaDescription
                    - mission
                    - successCriteria
                  description: Field name to regenerate
                simulationName:
                  type: string
                  description: Current scenario name
                personaName:
                  type: string
                  description: Current persona name
                personaDescription:
                  type: string
                  description: Current persona description
                mission:
                  type: string
                  description: Current mission
                successCriteria:
                  type: array
                  description: Current success criteria array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Success criterion type
                      params:
                        type: object
                        description: Success criterion parameters
                    required:
                      - type
                      - params
                successCriteriaIndex:
                  type: integer
                  description: >-
                    Optional: Index of specific success criterion to regenerate
                    (only when fieldToRegenerate is 'successCriteria')
              required:
                - fieldToRegenerate
                - simulationName
                - personaName
                - personaDescription
                - mission
                - successCriteria
      responses:
        '200':
          description: Persona field regenerated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Whether the regeneration was successful
                  personaPackage:
                    type: object
                    description: Complete persona package with the regenerated field
                    properties:
                      simulationName:
                        type: string
                        description: Simulation name
                      personaName:
                        type: string
                        description: Persona name
                      personaDescription:
                        type: string
                        description: Persona description
                      mission:
                        type: string
                        description: Mission
                      successCriteria:
                        type: array
                        description: Success criteria
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              description: Success criterion type
                            params:
                              type: object
                              description: Success criterion parameters
                          required:
                            - type
                            - params
                    required:
                      - simulationName
                      - personaName
                      - personaDescription
                      - mission
                      - successCriteria
                  metadata:
                    type: object
                    description: Optional metadata about the regeneration
                    properties:
                      requestId:
                        type: string
                        description: Request identifier
                      processedAt:
                        type: string
                        description: Timestamp when processed
                      model:
                        type: string
                        description: LLM model used
                      regeneratedField:
                        type: string
                        description: Field that was regenerated
                      regeneratedIndex:
                        type: integer
                        description: Index of regenerated success criterion (if applicable)
                required:
                  - success
                  - personaPackage
        '400':
          description: Bad Request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Validation error message
                  field:
                    type: string
                    description: Field that failed validation
                  code:
                    type: string
                    description: Validation error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
                  - field
        '401':
          description: Unauthorized - Invalid or missing authentication
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Unauthorized error message
                  code:
                    type: string
                    description: Unauthorized error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Forbidden error message
                  code:
                    type: string
                    description: Forbidden error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
        '500':
          description: Internal Server Error - Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  code:
                    type: string
                    description: Error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Bearer Token for authentication
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````