Delete a comment from a program, task, or request

delete

https://api.seismic.com/programs/v2/spaces/{spaceId}/nodes/{nodeId}/comments/{commentId}

Removes a comment from the specified entity (program, task, or request). Only the comment author or users
with appropriate management permissions can delete comments.

Key Features:

Removes the comment and all associated data
Validates user permissions before allowing deletion
Maintains audit trail for deletion operations
Ensures data consistency across related entities

Authorization Logic:

User must have a valid JWT token with program management scopes
User must be the comment author or have management permissions for the entity
User must have access to the space containing the entity

Usage Example:

Remove outdated or inappropriate comments from program discussions to maintain clean collaboration spaces.

Path Params

spaceId

string

required

length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

nodeId

string

required

The unique identifier of the entity (program, task, or request) containing the comment. This entity must exist within
the specified space and be accessible to the authenticated user.

commentId

string

required

The unique identifier of the comment to delete. The comment must exist on the specified entity and the user
must have appropriate permissions to delete it.

Responses

204

Comment deleted successfully. No content is returned.

400Invalid request data. Common causes include malformed comment ID, node ID, or space ID.

401Authentication failed due to missing, invalid, or expired JWT token. Obtain a valid token with required permission scopes.

403Access denied due to insufficient permissions to access entity or perform the requested action. Contact your administrator for assistance.

404Entity not found. Verify the entity ID exists to ensure proper permissions are granted.

500Internal server error during entity retrieval, mutation, or deletion.