Get an upload

GET/uploads/{uploadId}

Base URL https://app.testsigma.com/api/v1Region

Retrieve the details of a single uploaded file by its upload ID, including a pre-signed download URL.

Authenticate with your API key as a Bearer token in the Authorization header. How to authenticate →

Path parameters

uploadId ID of the upload to retrieve. Available from the Uploads page via the Copy Path option.

Response attributes

`id`	Unique upload identifier.
`projectId`	ID of the project the file belongs to.
`createdById`	ID of the user who created the upload.
`updatedById`	ID of the user who last updated the upload.
`createdDate`	Epoch timestamp when the file was created.
`updatedDate`	Epoch timestamp when the file was last updated.
`name`	Name of the file.
`appPath`	Path of the file in the application's storage.
`fileName`	Filename including extension.
`uploadType`	Type of upload — e.g. Attachment.
`version`	Version label of the file, if any.
`platformType`	Platform the file targets — e.g. TestsigmaLab.
`isPublic`	Whether the file is publicly accessible.
`uploadStatus`	Upload status — e.g. Completed.
`fileSize`	Size of the file in bytes.
`preSignedURL`	Pre-signed URL granting temporary access to the file.
`signed`	Whether the pre-signed URL is signed.

Request

curl -X GET \
  'https://app.testsigma.com/api/v1/uploads/{uploadId}' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json'

const response = await fetch('https://app.testsigma.com/api/v1/uploads/{uploadId}', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

import requests

response = requests.get(
  'https://app.testsigma.com/api/v1/uploads/{uploadId}',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
)
data = response.json()

Response200 OK

{
  "id": 147,
  "projectId": 11,
  "createdById": 43,
  "updatedById": 43,
  "createdDate": 1633535450000,
  "updatedDate": 1635322081221,
  "name": "test-file",
  "appPath": "testsigmatech.com/uploads/11/147/Testfile.pdf",
  "fileName": "Testfile.pdf",
  "uploadType": "Attachment",
  "version": null,
  "testsigmaAppId": null,
  "browserStackAppId": null,
  "sauceLabsAppId": null,
  "platformType": "TestsigmaLab",
  "isPublic": null,
  "uploadStatus": "Completed",
  "message": "Uploaded successfully",
  "status": 1,
  "fileSize": 334666,
  "preSignedURL": "https://s3.amazonaws.com/.../Testfile.pdf?X-Amz-Signature=...",
  "signed": false
}

Was this page helpful?