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

# Actualizar Modelo

> Update the configuration of an existing analysis model. All fields will be replaced
with the provided values.



## OpenAPI

````yaml PUT /v1/models/{id}
openapi: 3.0.2
info:
  title: Neuracall API
  description: >-

    ## Overview


    The Neuracall API provides powerful call analysis capabilities for contact
    centers and customer service teams.

    Submit audio recordings and receive detailed analysis including:


    - **Transcription**: Accurate speech-to-text conversion

    - **Quality Scoring**: Automated evaluation against customizable criteria

    - **Insights & Keywords**: AI-extracted conversation highlights

    - **Statistics**: Aggregated performance metrics


    ## Authentication


    All API endpoints (except `/v1/auth`) require a Bearer token. Obtain your
    token using the Authentication endpoint with your client credentials.


    ```

    Authorization: Bearer <your_access_token>

    ```


    ## Support


    For questions or issues, contact support@neuracall.com
        
  contact:
    name: Neuracall Support
    url: https://neuracall.com/support
    email: support@neuracall.com
  license:
    name: Proprietary
    url: https://neuracall.com/license
  version: 1.0.0
servers: []
security: []
tags:
  - name: Authentication
    description: >-
      Obtain access tokens to authenticate your application. Required before
      making other API calls.
  - name: Analysis Models
    description: >-
      Manage analysis models that define evaluation criteria and scoring
      parameters for call analysis.
  - name: Model Categories
    description: >-
      Manage categories within analysis models. Categories group related
      evaluation variables and help organize the scoring structure.
  - name: Model Variables
    description: >-
      Manage evaluation variables within analysis models. Variables define
      specific scoring criteria used during call analysis.
  - name: Model Metadata
    description: >-
      Manage metadata fields within analysis models. Metadata defines additional
      information required when submitting calls for analysis (e.g., campaign,
      department).
  - name: Call Analysis
    description: >-
      Submit audio recordings for analysis and retrieve results including
      transcriptions, scores, and insights.
  - name: Statistics
    description: >-
      Retrieve aggregated statistics and performance metrics from analyzed calls
      for dashboards and reporting.
paths:
  /v1/models/{id}:
    put:
      tags:
        - Analysis Models
      summary: Update an existing analysis model
      description: >-
        Update the configuration of an existing analysis model. All fields will
        be replaced

        with the provided values.
      operationId: Update_Analysis_Model_v1_models__id__put
      parameters:
        - description: Unique identifier of the analysis model
          required: true
          schema:
            title: Id
            type: integer
            description: Unique identifier of the analysis model
          example: 1
          name: id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClientPromptRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientPromptResponse'
        '400':
          description: Invalid request data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Model not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    ClientPromptRequest:
      title: ClientPromptRequest
      required:
        - name
        - description
        - prompt
      type: object
      properties:
        name:
          title: Name
          maxLength: 255
          minLength: 1
          type: string
          description: Unique name for this analysis model
          example: Customer Service Evaluation v2
        description:
          title: Description
          type: string
          description: Detailed description of what this model evaluates
          example: >-
            Comprehensive evaluation model for customer service calls including
            greeting, problem resolution, and closing.
        prompt:
          title: Prompt
          type: string
          description: >-
            Analysis configuration defining evaluation criteria and scoring
            rules
        template_variables:
          title: Template Variables
          type: array
          items:
            $ref: '#/components/schemas/TemplateVariable'
          description: List of variables to extract during analysis
        transcription_prompt:
          title: Transcription Prompt
          type: string
          description: >-
            Custom prompt to guide audio transcription. Include domain-specific
            vocabulary, proper nouns, or context to improve accuracy.
          default: ''
          example: This is a customer service call for a telecommunications company.
        summarize_call:
          title: Summarize Call
          type: boolean
          description: Enable automatic call summary generation after analysis
          default: false
          example: true
        summarize_prompt:
          title: Summarize Prompt
          type: string
          description: >-
            Custom prompt for summary generation. Only used if summarize_call is
            true.
          default: ''
          example: Summarize the key points of this customer service call.
        neurascore_template:
          title: Neurascore Template
          type: boolean
          description: Whether this model uses the NeuraScore scoring system
          default: false
          example: false
        enabled:
          title: Enabled
          type: boolean
          description: >-
            Whether this model is active. Disabled models are hidden from
            listings.
          default: true
          example: true
      description: Request body for creating or updating an analysis model
      example:
        name: Customer Service Evaluation v2
        description: Comprehensive evaluation model for customer service calls
        prompt: Evaluate the call based on professional standards...
        template_variables:
          - key: greeting_quality
            type: INTEGER
            required: true
          - key: resolution_achieved
            type: BOOLEAN
            required: true
        transcription_prompt: Customer service call for telecom company.
        summarize_call: true
        summarize_prompt: Summarize the key points of this call.
        neurascore_template: false
        enabled: true
    ClientPromptResponse:
      title: ClientPromptResponse
      required:
        - id
        - client_id
        - name
        - description
        - prompt
        - summarize_call
        - neurascore_template
        - enabled
        - created_at
        - created_by
      type: object
      properties:
        id:
          title: Id
          type: integer
          description: Unique identifier for this model
          example: 1
        client_id:
          title: Client Id
          type: string
          description: Owner client identifier
          example: client_abc123
        name:
          title: Name
          type: string
          description: Model name
          example: Customer Service Evaluation v2
        description:
          title: Description
          type: string
          description: Detailed description of the model
          example: Comprehensive evaluation model for customer service calls
        prompt:
          title: Prompt
          type: string
          description: Analysis configuration and evaluation criteria
        template_metadata:
          title: Template Metadata
          type: array
          items:
            $ref: '#/components/schemas/ClientTemplateMetadata'
          description: Configured metadata fields for additional data extraction
          default: []
        transcription_prompt:
          title: Transcription Prompt
          type: string
          description: Custom prompt for audio transcription
          default: ''
          example: Customer service call for telecom company.
        summarize_call:
          title: Summarize Call
          type: boolean
          description: Whether automatic summary generation is enabled
          example: true
        summarize_prompt:
          title: Summarize Prompt
          type: string
          description: Custom prompt for summary generation
          default: ''
          example: Summarize the key points of this call.
        neurascore_template:
          title: Neurascore Template
          type: boolean
          description: Whether this model uses the NeuraScore scoring system
          example: false
        enabled:
          title: Enabled
          type: boolean
          description: Whether this model is active and available for use
          example: true
        created_at:
          title: Created At
          type: string
          description: Timestamp when model was created (UTC)
          format: date-time
        created_by:
          title: Created By
          type: string
          description: Creator identifier
        updated_at:
          title: Updated At
          type: string
          description: Timestamp of last update (UTC)
          format: date-time
        updated_by:
          title: Updated By
          type: string
          description: Last updater identifier
      description: Analysis model details and configuration
    ErrorResponse:
      title: ErrorResponse
      required:
        - code
        - message
      type: object
      properties:
        code:
          title: Code
          type: string
          description: Error code for programmatic handling
          example: 001-001-0001
        path:
          title: Path
          type: string
          description: Field path for validation errors
          example: body.external_id
        message:
          title: Message
          type: string
          description: Human-readable error message
          example: The requested resource was not found
      description: Standard error response format for API errors
      example:
        code: 001-001-0001
        message: The requested resource was not found
    TemplateVariable:
      title: TemplateVariable
      required:
        - key
        - type
        - required
      type: object
      properties:
        key:
          title: Key
          type: string
          description: Unique identifier for this variable within the model
          example: greeting_quality
        type:
          allOf:
            - $ref: '#/components/schemas/VariableType'
          description: >-
            Data type: STRING, INTEGER, DECIMAL, BOOLEAN, DATE, TIME, or
            DATETIME
        required:
          title: Required
          type: boolean
          description: Whether this variable must have a value in analysis results
          example: true
      description: Variable definition for analysis model configuration
    ClientTemplateMetadata:
      title: ClientTemplateMetadata
      required:
        - id
        - key
        - type
      type: object
      properties:
        id:
          title: Id
          type: integer
          description: Unique identifier
          example: 1
        key:
          title: Key
          type: string
          description: Metadata field key
          example: department
        readable_name:
          title: Readable Name
          type: string
          description: Display name for the field
          example: Department
        type:
          allOf:
            - $ref: '#/components/schemas/MetadataType'
          description: Data type of the metadata field
      description: Metadata field configuration for an analysis model
    VariableType:
      title: VariableType
      enum:
        - STRING
        - INTEGER
        - DECIMAL
        - BOOLEAN
        - DATE
        - TIME
        - DATETIME
      description: An enumeration.
    MetadataType:
      title: MetadataType
      enum:
        - STRING
        - INTEGER
        - DECIMAL
        - BOOLEAN
        - DATE
        - TIME
        - DATETIME
      description: An enumeration.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````