Get project upload details

Retrieves complete details for a specific project upload, including all file metadata and organization information.

What is returned:

Upload identification (ID, project ID, file ID)
File metadata (filename, MIME type, file size in bytes)
Organization details (description, category ID)
User information (user ID who created the upload)
Timestamps (creation and last update dates in ISO 8601 format)

Note: This endpoint requires the Projects.manageUploads permission. Only uploads from projects the user has access to can be retrieved.

GET/projects/uploads/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Responses

200

categoryIdobject | nullrequired

UUID of the category assigned to this upload for thematic organization. Can be null if no category is assigned.

createdAtstringrequired

ISO 8601 formatted timestamp indicating when the upload record was created. Format: YYYY-MM-DDTHH:mm:ss.sssZ

descriptionobject | nullrequired

Free text description for classifying the upload content. Can be null if no description was provided.

fileIdstringrequired

UUID of the underlying file in workspace storage. This references the file uploaded via POST /workspace/upload.

fileNamestringrequired

Original filename of the uploaded file, as stored in the File relation. This is the name the file had when uploaded.

fileSizenumberrequired

Size of the file in bytes. Use this to display file sizes in a human-readable format (e.g., KB, MB).

idstringrequired

Unique identifier for the project upload record (UUID format)

mimeTypestringrequired

MIME type of the file indicating its format (e.g., application/pdf, image/png, text/plain). Retrieved from the File relation.

projectIdstringrequired

UUID of the project this upload belongs to. Determines which project the file is associated with.

updatedAtstringrequired

ISO 8601 formatted timestamp indicating when the upload record was last updated. Format: YYYY-MM-DDTHH:mm:ss.sssZ. This changes whenever any field of the upload is modified.

userIdstringrequired

UUID of the user who created this upload. This identifies who uploaded or last updated the file.

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X GET "https://leadtime.app/api/public/projects/uploads/string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/projects/uploads/string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/projects/uploads/string",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "categoryId": "123e4567-e89b-12d3-a456-426614174222",
  "createdAt": "2024-01-01T12:00:00.000Z",
  "description": "Project documentation for Q1 2024",
  "fileId": "123e4567-e89b-12d3-a456-426614174111",
  "fileName": "documentation.pdf",
  "fileSize": 1048576,
  "id": "123e4567-e89b-12d3-a456-426614174333",
  "mimeType": "application/pdf",
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2024-01-02T14:30:00.000Z",
  "userId": "123e4567-e89b-12d3-a456-426614174444"
}