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

# Get Evaluation Log Details

> Retrieves detailed logs for a specific evaluation template, with support for advanced filtering, sorting, and pagination. This endpoint uses a GET request with a request body to handle complex filtering and sorting configurations.



## OpenAPI

````yaml /openapi.json get /model-hub/get-eval-logs-details/
openapi: 3.0.0
info:
  title: FutureAGI Unified API
  version: 1.0.0
  description: >-
    Complete API documentation for FutureAGI platform - Simulate module
    (scenario management, agent definitions, test executions, call analytics)
    and Model Hub Evaluations API (evaluation templates, playgrounds, metrics,
    and execution tracking)
  contact:
    email: support@futureagi.com
servers:
  - url: https://api.futureagi.com
    description: Production API
security: []
tags:
  - name: Health
    description: Health check operations for monitoring server status
  - name: Authentication
    description: User authentication and token management
  - name: Scenarios
    description: Test scenario management and execution
  - name: Agent Definitions
    description: Agent definition CRUD operations
  - name: Agent Versions
    description: Agent version control and management
  - name: Simulator Agents
    description: Simulator agent operations
  - name: Run Tests
    description: Test execution management
  - name: Test Executions
    description: Test execution tracking and analytics
  - name: Call Executions
    description: Individual call execution details
  - name: Call Transcripts
    description: Transcript management and retrieval
  - name: Personas
    description: Persona management for testing
  - name: Analytics
    description: Analytics and reporting
  - name: Export Simulate
    description: Data export operations
  - name: Datasets
    description: >-
      Operations related to datasets, including creation, modification, and data
      management.
  - name: Eval Groups
    description: Evaluation group management
  - name: Eval Templates
    description: Base evaluation template operations
  - name: Custom Eval Templates
    description: Custom evaluation template CRUD operations
  - name: Eval Playground
    description: Test and run evaluations in playground environment
  - name: Eval Logs & Metrics
    description: Evaluation logs, metrics, and execution tracking
  - name: Eval Configuration
    description: Evaluation configuration and templates retrieval
  - name: API Keys
    description: API key management
  - name: Prompt Workbench
    description: Prompt template version labeling and lookup by name, version, or label
paths:
  /model-hub/get-eval-logs-details/:
    get:
      tags:
        - Eval Logs & Metrics
      summary: Get Evaluation Log Details
      description: >-
        Retrieves detailed logs for a specific evaluation template, with support
        for advanced filtering, sorting, and pagination. This endpoint uses a
        GET request with a request body to handle complex filtering and sorting
        configurations.
      operationId: getEvalLogDetails
      parameters:
        - name: eval_template_id
          in: query
          required: true
          description: The UUID of the evaluation template to retrieve logs for.
          schema:
            type: string
            format: uuid
        - name: page_size
          in: query
          required: false
          description: The number of log entries to return per page.
          schema:
            type: integer
            default: 10
        - name: current_page_index
          in: query
          required: false
          description: The index of the page to retrieve.
          schema:
            type: integer
            default: 0
        - name: source
          in: query
          required: false
          description: The source of the logs to filter by.
          schema:
            type: string
            enum:
              - logs
              - feedback
              - eval_playground
            default: logs
        - name: search
          in: query
          required: false
          description: A search term to filter log data across all columns.
          schema:
            type: string
      requestBody:
        description: Optional filtering and sorting configurations.
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                filters:
                  type: array
                  items:
                    $ref: '#/components/schemas/FilterItem'
                  description: A list of filters to apply to the log data.
                sort:
                  type: array
                  items:
                    $ref: '#/components/schemas/SortItem'
                  description: A list of sorting configurations to apply.
      responses:
        '200':
          description: Successfully retrieved the evaluation log details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LogDetailsResponse'
        '400':
          description: >-
            Bad Request. The request is missing the 'eval_template_id' or
            contains invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            Unauthorized. Authentication credentials were not provided or are
            invalid.
        '500':
          description: >-
            Internal Server Error. An unexpected error occurred while fetching
            the log details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
          SecretKeyAuth: []
components:
  schemas:
    FilterItem:
      type: object
      properties:
        filter_config:
          type: object
          properties:
            filter_type:
              type: string
              description: The type of filter to apply (e.g., 'datetime').
            filter_value:
              type: array
              items: {}
              description: >-
                The value(s) to filter by. For 'datetime', this is an array with
                start and end date strings.
    SortItem:
      type: object
      properties:
        column_id:
          type: string
          description: The ID of the column to sort by.
        type:
          type: string
          enum:
            - ascending
            - descending
          description: The sort direction.
    LogDetailsResponse:
      type: object
      properties:
        table:
          type: array
          items:
            $ref: '#/components/schemas/RowData'
        columnConfig:
          type: array
          items:
            $ref: '#/components/schemas/ColumnConfig'
        metadata:
          type: object
          properties:
            total_rows:
              type: integer
            total_pages:
              type: integer
    Error:
      type: object
      properties:
        error:
          type: string
    RowData:
      type: object
      description: >-
        Represents a single row in the log table, with keys corresponding to
        column IDs.
      additionalProperties:
        $ref: '#/components/schemas/CellData'
    ColumnConfig:
      type: object
      description: Configuration for a single column in the log details table.
      properties:
        id:
          type: string
        name:
          type: string
    CellData:
      type: object
      description: Represents the data within a single cell of the log table.
      properties:
        cell_value:
          description: The value of the cell.
        status:
          type: string
          nullable: true
        color:
          type: string
          nullable: true
        icon:
          type: string
          nullable: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        API Key for authentication. Click
        [here](https://app.futureagi.com/dashboard/keys) to access API Key
    SecretKeyAuth:
      type: apiKey
      in: header
      name: X-Secret-Key
      description: >-
        Secret Key for authentication. Click
        [here](https://app.futureagi.com/dashboard/keys) to access Secret Key

````