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

# Copy a file to a new path within the workspace

> Stage a copy of a file at a new path: what the workspace stages for the file, with any data frame edits, or else the file in the workspace's base commit. The copy shares the source's content, so nothing is uploaded. A copy with a different extension gets the type and metadata an upload of the same bytes to the new path would.



## OpenAPI

````yaml https://hub.oxen.ai/api/_spec/oxen_server_openapi.json post /api/repos/{namespace}/{repo_name}/workspaces/{workspace_id}/copy/{path}
openapi: 3.1.0
info:
  description: >-
    Oxen server is a fast data version control backend, supporting local disk
    and S3. Self host your repositories on your own storage, or use the hosted
    platform on Oxen.ai. Stores, syncs, and serves versioned datasets, model
    checkpoints, game assets, studio media, and any large data. Use the oxen CLI
    to push and pull from the oxen server.
  license:
    name: ''
  title: oxen-server
  version: 0.68.0
servers:
  - description: Production API
    url: https://hub.oxen.ai
  - description: Local Development
    url: http://localhost:3000
security:
  - api_key: []
tags:
  - description: Namespace management endpoints
    name: Namespaces
  - description: Repository management endpoints.
    name: Repositories
  - description: >-
      Editing a data frame inside a workspace, including its schema and column
      metadata.
    name: Workspace Data Frames
paths:
  /api/repos/{namespace}/{repo_name}/workspaces/{workspace_id}/copy/{path}:
    post:
      tags:
        - Workspace Files
      summary: Copy a file to a new path within the workspace
      description: >-
        Stage a copy of a file at a new path: what the workspace stages for the
        file, with any data frame edits, or else the file in the workspace's
        base commit. The copy shares the source's content, so nothing is
        uploaded. A copy with a different extension gets the type and metadata
        an upload of the same bytes to the new path would.
      operationId: copy
      parameters:
        - description: The namespace of the repository
          example: ox
          in: path
          name: namespace
          required: true
          schema:
            type: string
        - description: The name of the repository
          example: ImageNet-1k
          in: path
          name: repo_name
          required: true
          schema:
            type: string
        - description: The UUID of the workspace
          example: 580c0587-c157-417b-9118-8686d63d2745
          in: path
          name: workspace_id
          required: true
          schema:
            type: string
        - description: The path of the file to copy
          example: annotations/train.csv
          in: path
          name: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            example:
              new_path: annotations/train_results.csv
              overwrite: false
            schema:
              $ref: '#/components/schemas/CopyRequest'
        description: The path for the copy, and whether it replaces a file already there
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusMessage'
          description: >-
            Copy staged: resource_created when no file was at new_path,
            resource_updated when the copy replaced one
        '400':
          description: >-
            Invalid request (an empty or out-of-workspace path, or the path is a
            directory)
        '404':
          description: Workspace or file not found
        '409':
          description: >-
            A file is at new_path and overwrite is false, a directory is at
            new_path, new_path is the source, a file is at a parent of new_path,
            or the source is staged for removal
components:
  schemas:
    CopyRequest:
      properties:
        new_path:
          default: ''
          example: path/to/copy.txt
          type: string
        overwrite:
          default: false
          description: >-
            Replace a file at `new_path`, committed or staged, rather than
            refuse the copy.
          type: boolean
      type: object
    StatusMessage:
      properties:
        oxen_version:
          type:
            - string
            - 'null'
        status:
          type: string
        status_message:
          type: string
      required:
        - status
        - status_message
      type: object
  securitySchemes:
    api_key:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.