Upload Files

The upload files endpoint allows you to upload files to QA Sphere. The uploaded files can then be referenced in test cases, results etc.

Upload File

POST/api/public/v0/file

Upload a file to QA Sphere.

Authentication

Requires an API key with at least Viewer role permissions. See Authentication for more details.

Request Body

Request body should be a multipart/form-data with a file form-field.

Response Fields

Field	Type	Description
id	string	Unique identifier for the uploaded file
url	string	URL of the uploaded file

Example Request

curl \
  -H "Authorization: ApiKey your.api.key.here" \
  -F 'file=@"/path/to/file"' \
  https://your-company.your-region-code.qasphere.com/api/public/v0/file

Example Response

{
  "id": "1CJLabPkq_PWeS4siaKcB1k",
  "url": "https://your-company.your-region-code.qasphere.com/api/file/1CJLabPkq_PWeS4siaKcB1k"
}

Error Responses

Status Code	Description
401	Invalid or missing API key
403	Insufficient permissions or suspended tenant
500	Internal server error while uploading file