Skip to content

Delete an owned discussion comment ​

Signed project-user token required. Only the original external author can mutate a public/widget comment. Tenant, project, parent record, and comment scopes are checked. Eligible discussion changes sync to GitHub; internal notes and automatic AI comments remain local.

Request preparation ​

Send a DELETE request to /s/{slug}/discussion/{kind}/{recordId}/comments/{commentId} on the appropriate server. Check the API overview for base URL guidance and the server information in the interactive reference. Replace path placeholders with identifiers from the intended account or site; a similarly named record in another workspace is not interchangeable.

The declared request parameters are:

  • slug (path, required): Use the type and constraints shown in the parameter reference.
  • kind (path, required): Use the type and constraints shown in the parameter reference.
  • recordId (path, required): Use the type and constraints shown in the parameter reference.
  • commentId (path, required): Use the type and constraints shown in the parameter reference.
  • Authorization (header, required): Bearer signed project-user JWT

No request body is declared in the current specification. Check the route and any documented parameters before sending the request rather than adding an arbitrary JSON payload.

Authentication and scope ​

This operation does not declare an OpenAPI security requirement. Check the description and parameter definitions for any signed URL, customer identity, webhook, or browser-session conditions before using it outside a test environment.

Keep credentials in the appropriate private configuration and remove secrets from shared logs. Confirm the target resource belongs to the intended workflow before issuing a request. Authentication alone should not be treated as confirmation that a supplied account, site, or customer identifier is correct.

Response handling ​

The documented responses for Delete an owned discussion comment are:

  • 200: Updated or deleted owned comment
  • 401: Signed user required
  • 403: Comment belongs to another author
  • 404: Comment not found in project and parent scope

Before sending this deletion request, verify the exact resource and the consequences described for this operation. Use disposable test data for an initial integration check. Inspect the response before removing the record from your local interface, and do not assume that every delete operation has the same retention, cleanup, or recovery behavior.

If a connection fails after submission, investigate the current server state before repeating an action whose outcome is uncertain. When requesting support, retain the method, route, response status, and sanitized error message. The interactive reference below provides the detailed schemas and examples for this specific operation.

Delete an owned discussion comment​

DELETE
/s/{slug}/discussion/{kind}/{recordId}/comments/{commentId}

Signed project-user token required. Only the original external author can mutate a public/widget comment. Tenant, project, parent record, and comment scopes are checked. Eligible discussion changes sync to GitHub; internal notes and automatic AI comments remain local.

Parameters​

Header Parameters

Authorization*

Bearer signed project-user JWT

Type
string
Required

Path Parameters

slug*
Type
string
Required
kind*
Type
string
Required
Valid values
"feedback""release"
recordId*
Type
string
Required
commentId*
Type
string
Required

Responses​

Updated or deleted owned comment

Playground​

Headers
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI