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

# Retrieves the entry found at the given path.

> If the entry is a directory, lists all its accessible children recursively by default.



## OpenAPI

````yaml get /activeviam/content/rest/v8/files
openapi: 3.0.0
info:
  title: Atoti REST services
  version: 6.1.18-SNAPSHOT
servers:
  - description: Generated server url
    url: http://localhost:9090
security: []
tags:
  - description: Implementation of the REST API controller for an ActivePivot database.
    name: Database REST API
  - description: >
      XML for Analysis (XMLA) endpoint for executing MDX queries and OLAP
      discovery operations.


      This endpoint implements the XMLA protocol which is used by:

      - Microsoft Excel and other OLAP clients

      - Custom BI tools that support XMLA connectivity


      The endpoint supports both text XML and binary XML formats for improved
      performance.
    name: XMLA API
  - description: Definition of REST API to query data from ActivePivot (V10).
    name: Query REST API (V10)
  - description: Definition of REST API to query data from ActivePivot (V9).
    name: Query REST API (V9)
  - description: Implementation of the REST Bulk API of the content server (version 8).
    name: Bulk REST API
  - description: Implementation of the REST API of the content server.
    name: Content Server REST API
  - description: Implementation of the REST API controller for an ActivePivot database.
    name: Database REST API v9
  - description: ' Definition of the REST service returning the list of services exposed by an application.'
    name: Version REST API
  - description: Rest Service providing the discovery information.
    name: Discovery REST API
  - description: API to access measures information.
    name: Diagnostics API
  - description: JSON Web Token (JWT) endpoint.
    name: JWT API
  - description: >
      Endpoints to retrieve and manage query history.


      **Note:** This API is experimental and may change in future versions
      without notice.
    name: Query History REST API (Experimental)
  - description: Description of REST API to configure an ActivePivot application.
    name: Configuration REST API
  - description: API to export the result of MDX queries
    name: Data Export
  - description: >
      GetAggregatesQuery (GAQ) REST API for executing OLAP queries.


      This API provides a programmatic way to execute GetAggregatesQuery
      operations

      against Atoti cubes. Results and updates are streamed in Apache Arrow
      format for efficient

      data transfer and processing.
    name: Continuous GAQ Query REST API (Experimental)
  - description: Endpoints for AI-based optimization of Atoti cubes
    name: AI Optimizer
  - description: >
      GetAggregatesQuery (GAQ) REST API for executing OLAP queries.


      This API provides a programmatic way to execute GetAggregatesQuery
      operations

      against Atoti cubes. Results are returned in Apache Arrow format for
      efficient

      data transfer and processing.


      **Note:** This API is experimental and may change in future versions
      without notice.
    name: GAQ Query REST API (Experimental)
  - description: Implementation of the REST Bulk API of the content server.
    name: Bulk REST API
paths:
  /activeviam/content/rest/v8/files:
    get:
      tags:
        - Content Server REST API
      summary: Retrieves the entry found at the given path.
      description: >-
        If the entry is a directory, lists all its accessible children
        recursively by default.
      operationId: getFiles
      parameters:
        - description: he path to apply the operation to.
          in: query
          name: path
          required: true
          schema:
            default: /
            type: string
        - description: >-
            If the path is a directory, the maximum depth at which to retrieve
            children. -1 means that all available children are retrieved, 0
            means that only the directory itself is retrieved.
          in: query
          name: recursiveParam
          required: true
          schema:
            default: '-1'
            description: Default is -1.
            type: string
        - description: >-
            When set, the content of the retrieved file is included in the
            response.
          in: query
          name: includeContentParam
          required: true
          schema:
            default: 'true'
            enum:
              - 'false'
              - 'true'
            type: string
        - in: query
          name: recursive
          required: false
          schema:
            default: '-1'
            type: string
        - in: query
          name: includeContent
          required: false
          schema:
            default: 'true'
            type: string
      responses:
        '200':
          content:
            application/json:
              example: null
              schema:
                $ref: '#/components/schemas/JsonContentTree'
          description: Request completed successfully.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonContentTree'
          description: Bad Request – The format of the request was invalid.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonContentTree'
          description: >-
            Forbidden – The user is allowed to see the entry, and asked for its
            content or children, but does not have read access to it.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonContentTree'
          description: >-
            Not Found – The entry does not exist, or the user does not have the
            permissions to see it.
components:
  schemas:
    JsonContentTree:
      description: Tree structure representing content hierarchy with metadata
      properties:
        children:
          additionalProperties:
            $ref: '#/components/schemas/JsonContentTree'
          description: Map of child tree nodes
          type: object
        entry:
          description: Content entry information
          type: object
      type: object

````