DOCS
Reference

API: Test files

Test files: List a test's files, Add a test file, Delete a test file.

List a test's files

GET/api/v1/tests/{testId}/files

Files a test can upload during its steps (for example an import file).

MCP tool: list_test_files. Works with any key.

Path
testIdstringrequired
Test id (t_…)

Returns { files: [{ name, size, contentType, createdAt }] }

Request
curl https://app.testsy.dev/api/v1/tests/t_mvg0/files \
  -H "Authorization: Bearer $QA_AI_API_KEY"

Add a test file

POST/api/v1/tests/{testId}/files

Add a file the tester can upload during the test: up to 25 MB, up to 10 files per test. REST: send the raw bytes as the body with the file name in the X-File-Name header (or ?name=), or JSON {name, contentBase64}. MCP: name and contentBase64. A file with the same name replaces the old one.

MCP tool: add_test_file. Needs a key that can also create and edit tests.

Path
testIdstringrequired
Test id (t_…)
Body (JSON)
namestringrequired
File name, for example orders-march.csv
contentBase64string
The file's bytes, base64-encoded
contentTypestring
Media type, for example text/csv (optional)

Returns 201 { name, size }

Request
curl -X POST https://app.testsy.dev/api/v1/tests/t_mvg0/files \
  -H "Authorization: Bearer $QA_AI_API_KEY" \
  -H "X-File-Name: orders.csv" -H "Content-Type: text/csv" \
  --data-binary @orders.csv

Delete a test file

DELETE/api/v1/tests/{testId}/files/{name}

Remove one of a test's files.

MCP tool: delete_test_file. Needs a key that can also create and edit tests.

Path
testIdstringrequired
Test id (t_…)
namestringrequired
File name

Returns { ok: true }

Request
curl -X DELETE https://app.testsy.dev/api/v1/tests/t_mvg0/files/orders.csv \
  -H "Authorization: Bearer $QA_AI_API_KEY"