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

# Crear Modelo

> Create a new analysis model with custom scoring criteria and evaluation parameters.

The model defines how call recordings will be analyzed and scored. Include categories
and variables to structure your evaluation criteria.



## OpenAPI

````yaml POST /v1/models
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:
    post:
      tags:
        - Analysis Models
      summary: Create a new analysis model
      description: >-
        Create a new analysis model with custom scoring criteria and evaluation
        parameters.


        The model defines how call recordings will be analyzed and scored.
        Include categories

        and variables to structure your evaluation criteria.
      operationId: Create_Analysis_Model_v1_models_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClientPromptRequest'
        required: true
      responses:
        '201':
          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'
        '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

````