Delete a comment

DELETEhttps://<your-url>/api/v2/comments/{comment}

MCP id comments.destroyAlso on this path: GET Read a comment, PATCH Edit a comment

Permanently deletes one comment and answers 204.

Token scope: api:destroy:project_managementorapi:destroy:project_driveorapi:destroy:customer_driveorapi:destroy:organization_driveorapi:destroy:user_drive
Without it: 403 insufficient-token-scope.
Permission: project_management::manage_work_items
Without it: 403 insufficient-permission.
Rate cost: 1 unit, write bucket.
Also: Accepts If-Match. Never cached: private, no-store. Unknown query parameters are refused, never ignored.

Both are checked, scope first. A token never does more than its user. How access is checked

Request

Example: Remove your own comment

curl -X DELETE \
  'https://<your-url>/api/v2/comments/1' \
  -H 'Authorization: Bearer <token>' \
  -H 'Accept: application/json'

const response = await fetch('https://<your-url>/api/v2/comments/1', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer <token>',
    'Accept': 'application/json',
  },
});

use Illuminate\Support\Facades\Http;

$response = Http::withToken('<token>')
    ->acceptJson()
    ->delete('https://<your-url>/api/v2/comments/1');

import requests
response = requests.request(
    'DELETE',
    'https://<your-url>/api/v2/comments/1',
    headers={'Authorization': 'Bearer <token>', 'Accept': 'application/json'},
)

Response

No body.

{
  "type": "https://developers.plnnrly.com/api/v2/problems/precondition-failed",
  "title": "Precondition failed",
  "status": 412,
  "detail": "The record changed since the version named in If-Match. Re-read it and retry.",
  "instance": "/api/v2/work-items/812",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "current_version": 12
}

Deleting is author-only, on the same terms as editing: no permission lets a manager delete somebody else's comment, a DELETE by a non-author is 403 forbidden-by-policy, and the caller must additionally be able to comment on the parent (project_management::manage_work_items for a work item, read access to the drive document for a drive item), with a token covering that parent's prefix. There is no soft delete, no ?force parameter and no restore verb: a comment comes back only by being posted again, as a new comment with a new id and a new timestamp. A second DELETE of the same id is 404.

Path parameters

commentintegerRequired

The Comment's numeric id.

Request headers

X-Request-Idstringpattern

A correlation id of your own. It is recorded in our logs next to the server's request id but never returned: the response header always carries the server's id. A value that does not match the pattern is discarded silently, never rejected.

If-Matchstring

The ETag a write is conditional on. A stale validator is 412 precondition-failed.

Response 204

Returns no content.

Headers

RateLimit: The IETF httpapi-ratelimit-headers form of your remaining allowance on the tightest bucket this request touched.
RateLimit-Policy: The ceiling and window of that bucket, as <limit>;w=<seconds>.
X-Request-Id: The server-generated ULID correlating this response with our logs.

Every response also carries Cache-Control, Vary, X-Content-Type-Options, X-Plnnrly-Api-Version, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Headers and versioning

Errors

403 Forbidden.

forbidden-by-policy insufficient-permission insufficient-token-scope

forbidden-by-policy: You did not write this comment. Only its author can delete a comment, and no permission lets anyone else do it. You also get this answer when you can see the work item or drive item the comment belongs to but may not comment on it.

412 Precondition failed.

precondition-failed

7 errors every operation can return: 400, 401, 404, 406, 429, 500, 503

400 Bad request.

idempotency-key-required invalid-cursor invalid-query-parameter malformed-request unsupported-parameter

401 Unauthenticated.

token-expired unauthenticated

404 Not found.

endpoint-not-found resource-not-found

406 Not acceptable.

not-acceptable

429 Too many requests.