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

# Creates an entry at the given path or updates an existing one.

> If the permissions parameter is set, only the permissions of the entry are updated.



## OpenAPI

````yaml put /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:
    put:
      tags:
        - Content Server REST API
      summary: Creates an entry at the given path or updates an existing one.
      description: >-
        If the permissions parameter is set, only the permissions of the entry
        are updated.
      operationId: putMethod
      parameters:
        - description: The path to apply the operation to.
          in: query
          name: path
          required: true
          schema:
            default: /
            type: string
        - description: Whether only the permissions should be updated.
          in: query
          name: permissionsParam
          required: true
          schema:
            default: ignored
            type: string
        - in: query
          name: permissions
          required: false
          schema:
            default: ignored
            type: string
      requestBody:
        content:
          application/json:
            example: null
            schema:
              type: string
        description: The JSON parameters for the operation.
        required: true
      responses:
        '201':
          description: >-
            Created – Create or update completed successfully, and the entry has
            been stored.
        '400':
          description: >-
            Bad Request – The format of the request was invalid, or the user
            tried to overwrite an existing directory.
        '403':
          description: >-
            Forbidden - The entry exists but the user does not have write access
            to it, or the entry does not exist, but the user does not have
            access to its parent directory. Or the user tried to set disallowed
            owners/readers for the entry (The user must be part of at least one
            reader and owner role), or tried to change access permissions while
            not having write access to the entry.
        '404':
          description: >-
            Not Found – The entry does not exist, or the user does not have the
            permissions to see it.
        '409':
          description: Conflict – A entry already exists, and overwrite was not specified.

````