Reference
API: Share links
Share links: List share links, Create a share link, Turn off a share link.
List share links
GET/api/v1/runs/{runId}/shares
The share links made for a run, with when they expire and how often they were opened.
MCP tool: list_share_links. Works with any key.
| Path |
|---|
runIdstringrequired |
Returns { shares: [{ id, created_at, expires_at, revoked_at, views, viewed_at }] }
Request
curl https://app.testsy.dev/api/v1/runs/j_mvg1/shares \
-H "Authorization: Bearer $QA_AI_API_KEY"Create a share link
POST/api/v1/runs/{runId}/shares
A read-only link to a run's result, replay and video that anyone can open without signing in, until it expires.
MCP tool: create_share_link. Works with any key, including one that can only run tests and read results.
| Path |
|---|
runIdstringrequired |
| Body (JSON) |
|---|
daysnumber |
Returns 201 { id, url, expiresAt }
Request
curl -X POST https://app.testsy.dev/api/v1/runs/j_mvg1/shares \
-H "Authorization: Bearer $QA_AI_API_KEY"Turn off a share link
DELETE/api/v1/shares/{shareId}
Turn off a share link straight away.
MCP tool: delete_share_link. Works with any key, including one that can only run tests and read results.
| Path |
|---|
shareIdstringrequired |
Returns { ok: true }
Request
curl -X DELETE https://app.testsy.dev/api/v1/shares/sh_x2 \
-H "Authorization: Bearer $QA_AI_API_KEY"