---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    Creates a new project upload record, linking an uploaded file to a project.
    Reference for the POST /projects/uploads endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Create project upload
title: Create project upload
type: openapi-operation
---
Creates a new project upload record, linking an uploaded file to a project.

**How to upload files:**
1. First, upload the file using POST /workspace/upload to obtain a fileId
2. Then use that fileId in this endpoint to create the project upload record

**Required fields:**
- projectId: The project to attach the upload to (must exist and user must have access)
- fileId: The file ID from the workspace upload endpoint (must exist in workspace)

**Optional fields:**
- description: Free text field for classifying the content (e.g., "Signed contract 10/28/2025", "Kickoff protocol")
- categoryId: Thematic classification for organizing uploads (e.g., Contract, Offer, Documentation)

**Validation:**
- Project must exist and belong to the workspace
- User must have access to the project
- File must exist and belong to the workspace
- Category must exist and belong to the workspace (if provided)

**What is returned:**
Complete upload details including file metadata, timestamps, and user information.

**Note:** This endpoint requires the Projects.manageUploads permission.

<Operation source="api-reference" id="projectuploadscontroller-createprojectupload" />