---
search:
  tags:
    - workspace
    - POST
seo:
  description: >-
    Uploads a file to the workspace and returns file metadata including a
    unique… Reference for the POST /workspace/upload endpoint in the Leadtime
    Public API API.
sidebar:
  badge: POST
  label: Upload file to workspace
title: Upload file to workspace
type: openapi-operation
---
Uploads a file to the workspace and returns file metadata including a unique file ID and public URL. This endpoint is used for uploading various file types such as logos, avatars, documents, or custom icons. The uploaded file is associated with the workspace and can be referenced in other API endpoints using the returned file ID. The file is stored securely and a public URL is generated for accessing it. Common use cases include uploading workspace logos (for light and dark themes), user avatars, or custom icon images. The optional type parameter can be used to categorize the file (e.g., "logo", "avatar", "document") for organizational purposes.

<Operation source="api-reference" id="workspacecontroller-uploadfile" />
