Skip to content

Take a comment back

DELETE
/v1/comments/{id}
curl --request DELETE \
--url https://beta-api.plune.ai/v1/comments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

B8-team T5 (api.ts → deleteComment, «Delete» on the row). The row is deleted at once (#1078): the text stays in the audit entry that names it, the list stops showing it. The author may take back their own; the owner or a manager of the project may take back anyone’s (ADR 0050 §10). Somebody else’s comment is answered 404 to everybody else — the same answer an id nobody has gets, on purpose. Audited on the case, suite, run or bug it was on (test_case, suite, run or bug / comment), the text as before. Works for a comment on a suite, a run or a bug too (M6, #1256; #1066).

id
required
string format: uuid
X-Plune-Project
string

Which of your projects to act in — an id from GET /v1/projects. Absent, your default project. A project you are not a member of answers 404, the same as one that does not exist. Ignored under a bearer token, which is bound to the project it was minted in.

Taken back

No / invalid token or session

A reader asked

Media type application/json
object
error
required
string
Example
{
"error": "read-only member"
}

Not yours to take back, already gone, or never there

Media type application/json
object
error
required
string
Example
{
"error": "comment '6f1c2b3a-0000-4000-8000-0000000000a4' not found"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over