Skip to content

The public report

Public report, on a run’s page under its tags, makes a link to a read-only page of the run that anyone can open without an account: a client, a manager outside the team, a channel. The page shows the run’s statuses, sub-statuses, durations and cost, and nothing can be changed from it.

Everyone in the project sees the Public report switch and what it says — On — the link answers or Off — the address answers 404. Only the project’s owner turns it on, makes a new link or revokes one; for anyone else the switch is greyed, and the API answers 403 · project owner only.

The owner clicks the switch. The link is made at once, with the defaults: it expires in 7 days and has no password. It is shown once, right after it is made, under Copy it now — you will not see it again, with a copy button. Plune keeps the address only hashed, so after a reload the panel says The link is shown once, when it is created. If you lost it, revoke it and create a new one. — there is no way to show it again.

Under the switch the panel then says when the link was made and by whom, when it expires, password required when it has one, and the address is stored hashed.

A live link keeps the date and the password it was made with. To change either, the owner makes a new link. While a link is live and has not expired, the panel shows two fields under These settings apply to the next link you create.:

  • Link expires after — 7 days at first. A number and a unit: 12 hours, 3 days; a number alone is days. From 1 hour to 30 days; the hint under the field says the date it gives.
  • Require a password — off at first: Off — anyone with the link can open it. Switched on, a Password field: 8 to 128 printable ASCII characters — letters, digits, punctuation, spaces. It is stored hashed and cannot be shown again.

Create a new link asks first: the old address stops working at once for everyone who has it, and the new one is shown once, right after it is made. Revoking and creating are written to the audit log.

Revoke link — or the switch, clicked while the report is on — asks Revoke the public link?. The link stops working at once for everyone who has it, and it cannot be restored; the old address answers 404. Switching the report on again makes a new address.

The page has a bar with Plune’s mark and the badge Public report, and no menu, no sign-in and no account. Its words are in the browser’s language, English when there is none Plune speaks. Then:

  • the run’s name, its kind, running or finished, when, and how long it took; the verdict; the environment and the labels;
  • four cards: Pass rate, Results, Duration and Cost — a dash and Not recorded for this run when the run holds no duration or no cost;
  • the counts of each status, then Sub-statuses with how many results carry each;
  • Results: each test’s name, status, sub-status, whether it went as expected, and its duration — failures first. The list shows 20 results, and Show N more adds up to 20 after them. One report lists 1,000 results at most; past that it says so, and the counts above stay the whole run’s.

At its foot: A read-only public report. Anyone with this address can see it; the owner can turn it off at any time.

The page asks no cache to keep it, no search engine to index it, and sends no referrer on.

The visitor seesWhy
Page not found. (404)The link was revoked, the project moved to another company, the run is in the Bin, or there is no such link. The page does not tell them apart.
This link has expired. (410)Its expiry has passed. The owner’s panel says Expired — the link answers 410 and when it expired; a new link shares the report again.
This report is protected.The link has a password. Open report sends it; Wrong password. Try again. when it is not right. The password is checked on the server; nothing is stored in the browser.
Too many wrong tries. Try again in …Ten wrong passwords within 15 minutes lock the link for every visitor until the oldest of them is 15 minutes old. The owner’s panel says until when.
Too many requests from this network.One network sent more than 30 passwords in a minute.

A lock does not change the link’s password or expiry. Someone who has the address can lock its visitors out by guessing; the owner then revokes it and shares a new link.

RequestWhoWhat it does
GET /v1/runs/{id}/public-reporta member of the projectThe state: enabled, and for a live link when it was made and by whom, expiresAt, expired, passwordProtected and lockedUntil. Never the address.
PUT /v1/runs/{id}/public-reportthe ownerTurns it on. The body is optional: { "expiresAt": "…", "password": "…" }. 201 with the link — path /public/report/<token>, and url — once. When a live link exists already: 200 with the state alone, and 409 · link_exists if the body sends a date or a password — revoke it to change them. An expired link is replaced by a new one.
DELETE /v1/runs/{id}/public-reportthe ownerRevokes the link: 204.
GET /public/report/{token}anyone, no credentialThe report. A password goes in the X-Report-Password header. 404 · 410 · 401 with password_required or wrong_password · 429 past the limits above.