Delete project update comment

DELETE/v1/projects/{projectId}/updates/{updateId}/comments/{commentId}

Delete a top-level project update comment authored by the authenticated user, including its replies.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
NameLocationTypeRequiredDescription
projectIdpathstringYesProject ID
updateIdpathstringYes—
commentIdpathstringYes—
Query parameters
None.

Body schema

This endpoint does not require a request body.

None.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Project update comment deletedapplication/json
FieldTypeRequiredDescription
deletedCommentIdstringNo—
updateobjectNo—
update.idstringYesUnique identifier.
update.bodystringYes—
update.kindupdate | commentYes—
update.statuson_track | at_risk | off_track | completeYesCurrent lifecycle status.
update.attachmentsobject[]Yes—
update.attachments[].idstringNoUnique identifier.
update.attachments[].filenamestringYes—
update.attachments[].mimeTypestringNo—
update.attachments[].sizeintegerNo—
update.attachments[].urlstringNo—
update.attachments[].previewUrlstringNo—
update.attachments[].workspacePathstringNo—
update.attachments[].sourcePathstringNoWorkspace-relative file path.
update.attachments[].environmentIdstringNoComputer ID.
update.commentsobject[]Yes—
update.comments[].idstringYesUnique identifier.
update.comments[].parentCommentIdstringNo—
update.comments[].bodystringYes—
update.comments[].attachmentsobject[]Yes—
update.comments[].attachments[].idstringNoUnique identifier.
update.comments[].attachments[].filenamestringYes—
update.comments[].attachments[].mimeTypestringNo—
update.comments[].attachments[].sizeintegerNo—
update.comments[].attachments[].urlstringNo—
update.comments[].attachments[].previewUrlstringNo—
update.comments[].attachments[].workspacePathstringNo—
update.comments[].attachments[].sourcePathstringNoWorkspace-relative file path.
update.comments[].attachments[].environmentIdstringNoComputer ID.
update.comments[].repliesobject[]YesDirect replies to this top-level update comment.
update.comments[].replies[].idstringYesUnique identifier.
update.comments[].replies[].parentCommentIdstringNo—
update.comments[].replies[].bodystringYes—
update.comments[].replies[].attachmentsobject[]Yes—
update.comments[].replies[].attachments[].idstringNoUnique identifier.
update.comments[].replies[].attachments[].filenamestringYes—
update.comments[].replies[].attachments[].mimeTypestringNo—
update.comments[].replies[].attachments[].sizeintegerNo—
update.comments[].replies[].attachments[].urlstringNo—
update.comments[].replies[].attachments[].previewUrlstringNo—
update.comments[].replies[].attachments[].workspacePathstringNo—
update.comments[].replies[].attachments[].sourcePathstringNoWorkspace-relative file path.
update.comments[].replies[].attachments[].environmentIdstringNoComputer ID.
update.comments[].replies[].repliesobject[]YesDirect replies to this top-level update comment.
update.comments[].replies[].replies[].idstringYesUnique identifier.
update.comments[].replies[].replies[].parentCommentIdstringNo—
update.comments[].replies[].replies[].bodystringYes—
update.comments[].replies[].replies[].attachmentsobject[]Yes—
update.comments[].replies[].replies[].attachments[].idstringNoUnique identifier.
update.comments[].replies[].replies[].attachments[].filenamestringYes—
update.comments[].replies[].replies[].attachments[].mimeTypestringNo—
update.comments[].replies[].replies[].attachments[].sizeintegerNo—
update.comments[].replies[].replies[].attachments[].urlstringNo—
update.comments[].replies[].replies[].attachments[].previewUrlstringNo—
update.comments[].replies[].replies[].attachments[].workspacePathstringNo—
update.comments[].replies[].replies[].attachments[].sourcePathstringNoWorkspace-relative file path.
update.comments[].replies[].replies[].attachments[].environmentIdstringNoComputer ID.
update.comments[].replies[].replies[].repliesobject[]YesDirect replies to this top-level update comment.
update.comments[].replies[].replies[].replies[].idstringYesUnique identifier.
update.comments[].replies[].replies[].replies[].parentCommentIdstringNo—
update.comments[].replies[].replies[].replies[].bodystringYes—
update.comments[].replies[].replies[].replies[].attachmentsobject[]Yes—
update.comments[].replies[].replies[].replies[].attachments[].idstringNoUnique identifier.
update.comments[].replies[].replies[].replies[].attachments[].filenamestringYes—
update.comments[].replies[].replies[].replies[].attachments[].mimeTypestringNo—
update.comments[].replies[].replies[].replies[].attachments[].sizeintegerNo—
update.comments[].replies[].replies[].replies[].attachments[].urlstringNo—
update.comments[].replies[].replies[].replies[].attachments[].previewUrlstringNo—
update.comments[].replies[].replies[].replies[].attachments[].workspacePathstringNo—
update.comments[].replies[].replies[].replies[].attachments[].sourcePathstringNoWorkspace-relative file path.
update.comments[].replies[].replies[].replies[].attachments[].environmentIdstringNoComputer ID.
update.comments[].replies[].replies[].replies[].repliesobject[]YesDirect replies to this top-level update comment.
update.comments[].replies[].replies[].replies[].replies[].idstringYesUnique identifier.
update.comments[].replies[].replies[].replies[].replies[].parentCommentIdstringNo—
update.comments[].replies[].replies[].replies[].replies[].bodystringYes—
update.comments[].replies[].replies[].replies[].replies[].attachmentsobject[]Yes—
update.comments[].replies[].replies[].replies[].replies[].attachments[].idstringNoUnique identifier.
update.comments[].replies[].replies[].replies[].replies[].attachments[].filenamestringYes—
update.comments[].replies[].replies[].replies[].replies[].attachments[].mimeTypestringNo—
update.comments[].replies[].replies[].replies[].replies[].attachments[].sizeintegerNo—
update.comments[].replies[].replies[].replies[].replies[].attachments[].urlstringNo—
update.comments[].replies[].replies[].replies[].replies[].attachments[].previewUrlstringNo—
update.comments[].replies[].replies[].replies[].replies[].attachments[].workspacePathstringNo—
update.comments[].replies[].replies[].replies[].replies[].attachments[].sourcePathstringNoWorkspace-relative file path.
update.comments[].replies[].replies[].replies[].replies[].attachments[].environmentIdstringNoComputer ID.
update.comments[].replies[].replies[].replies[].replies[].repliesobject[]YesDirect replies to this top-level update comment.
update.comments[].replies[].replies[].replies[].replies[].replies[].idstringYesUnique identifier.
update.comments[].replies[].replies[].replies[].replies[].replies[].parentCommentIdstringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].bodystringYes—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachmentsobject[]Yes—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].idstringNoUnique identifier.
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].filenamestringYes—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].mimeTypestringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].sizeintegerNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].urlstringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].previewUrlstringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].workspacePathstringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].sourcePathstringNoWorkspace-relative file path.
update.comments[].replies[].replies[].replies[].replies[].replies[].attachments[].environmentIdstringNoComputer ID.
update.comments[].replies[].replies[].replies[].replies[].replies[].repliesobject[]YesDirect replies to this top-level update comment.
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].idstringYesUnique identifier.
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].parentCommentIdstringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].bodystringYes—
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].attachmentsobject[]Yes—
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].repliesobject[]YesDirect replies to this top-level update comment.
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].authorobjectYes—
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].createdAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].replies[].replies[].replies[].replies[].updatedAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].replies[].replies[].replies[].authorobjectYes—
update.comments[].replies[].replies[].replies[].replies[].replies[].author.userIdstringYesUser ID.
update.comments[].replies[].replies[].replies[].replies[].replies[].author.namestringYesHuman-readable name.
update.comments[].replies[].replies[].replies[].replies[].replies[].author.emailstringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].author.avatarUrlstringNo—
update.comments[].replies[].replies[].replies[].replies[].replies[].createdAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].replies[].replies[].replies[].updatedAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].replies[].replies[].authorobjectYes—
update.comments[].replies[].replies[].replies[].replies[].author.userIdstringYesUser ID.
update.comments[].replies[].replies[].replies[].replies[].author.namestringYesHuman-readable name.
update.comments[].replies[].replies[].replies[].replies[].author.emailstringNo—
update.comments[].replies[].replies[].replies[].replies[].author.avatarUrlstringNo—
update.comments[].replies[].replies[].replies[].replies[].createdAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].replies[].replies[].updatedAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].replies[].authorobjectYes—
update.comments[].replies[].replies[].replies[].author.userIdstringYesUser ID.
update.comments[].replies[].replies[].replies[].author.namestringYesHuman-readable name.
update.comments[].replies[].replies[].replies[].author.emailstringNo—
update.comments[].replies[].replies[].replies[].author.avatarUrlstringNo—
update.comments[].replies[].replies[].replies[].createdAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].replies[].updatedAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].authorobjectYes—
update.comments[].replies[].replies[].author.userIdstringYesUser ID.
update.comments[].replies[].replies[].author.namestringYesHuman-readable name.
update.comments[].replies[].replies[].author.emailstringNo—
update.comments[].replies[].replies[].author.avatarUrlstringNo—
update.comments[].replies[].replies[].createdAtstringYesISO 8601 timestamp.
update.comments[].replies[].replies[].updatedAtstringYesISO 8601 timestamp.
update.comments[].replies[].authorobjectYes—
update.comments[].replies[].author.userIdstringYesUser ID.
update.comments[].replies[].author.namestringYesHuman-readable name.
update.comments[].replies[].author.emailstringNo—
update.comments[].replies[].author.avatarUrlstringNo—
update.comments[].replies[].createdAtstringYesISO 8601 timestamp.
update.comments[].replies[].updatedAtstringYesISO 8601 timestamp.
update.comments[].authorobjectYes—
update.comments[].author.userIdstringYesUser ID.
update.comments[].author.namestringYesHuman-readable name.
update.comments[].author.emailstringNo—
update.comments[].author.avatarUrlstringNo—
update.comments[].createdAtstringYesISO 8601 timestamp.
update.comments[].updatedAtstringYesISO 8601 timestamp.
update.reactionsobject[]Yes—
update.reactions[].emojistringYes—
update.reactions[].userIdsstring[]Yes—
update.reactions[].countintegerYes—
update.authorobjectYes—
update.author.userIdstringYesUser ID.
update.author.namestringYesHuman-readable name.
update.author.emailstringNo—
update.author.avatarUrlstringNo—
update.createdAtstringYesISO 8601 timestamp.
update.updatedAtstringYesISO 8601 timestamp.
projectobjectNo—
project.objectproject | project.overviewNo—
project.isOverviewRecordbooleanNo—
project.idstringYesUnique identifier.
project.userIdstringYesUser ID.
project.ownerUserIdstringNo—
project.ownerNamestringNo—
project.ownerEmailstringNo—
project.ownerAvatarUrlstringNo—
project.ownerobjectNo—
project.owner.userIdstringYesUser ID.
project.owner.namestringYesHuman-readable name.
project.owner.emailstringNo—
project.owner.avatarUrlstringNo—
project.canTransferOwnershipbooleanNo—
project.organizationIdstringNo—
project.createdByUserIdstringNo—
project.createdByNamestringNo—
project.createdByEmailstringNo—
project.createdByAvatarUrlstringNo—
project.createdByobjectNo—
project.createdBy.userIdstringYesUser ID.
project.createdBy.namestringYesHuman-readable name.
project.createdBy.emailstringNo—
project.createdBy.avatarUrlstringNo—
project.namestringYesHuman-readable name.
project.descriptionstringYesHuman-readable description.
project.typelocal | cloud | syncedNo—
project.primarySourcestringNo—
project.sourcesobject[]No—
project.colorstringYes—
project.defaultEnvironmentIdstringYes—
project.environmentIdsstring[]No—
project.permissionSetobjectNoAgent permission policy. The shape is intentionally subject-typed so it can also be reused for human users and teams later.
project.permissionSet.version1No—
project.permissionSet.subjectTypeagent | human_user | team | project | security_repositoryNo—
project.permissionSet.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.ringsobjectNo—
project.permissionSet.actionsobjectNo—
project.permissionSet.resourcesobjectNo—
project.permissionSet.resources.agentsobjectNo—
project.permissionSet.resources.agents.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.agents.rulesobject[]No—
project.permissionSet.resources.agents.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.agents.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.agents.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.agents.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.agents.rules[].notestringNoOptional human-readable note for the rule.
project.permissionSet.resources.skillsobjectNo—
project.permissionSet.resources.skills.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.skills.rulesobject[]No—
project.permissionSet.resources.skills.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.skills.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.skills.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.skills.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.skills.rules[].notestringNoOptional human-readable note for the rule.
project.permissionSet.resources.serversobjectNo—
project.permissionSet.resources.servers.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.servers.rulesobject[]No—
project.permissionSet.resources.servers.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.servers.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.servers.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.servers.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.servers.rules[].notestringNoOptional human-readable note for the rule.
project.permissionSet.resources.computersobjectNo—
project.permissionSet.resources.computers.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.computers.rulesobject[]No—
project.permissionSet.resources.computers.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.computers.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.computers.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.computers.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.computers.rules[].notestringNoOptional human-readable note for the rule.
project.permissionSet.resources.filesobjectNo—
project.permissionSet.resources.files.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.files.rulesobject[]No—
project.permissionSet.resources.files.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.files.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.files.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.files.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.files.rules[].notestringNoOptional human-readable note for the rule.
project.permissionSet.resources.directoriesobjectNo—
project.permissionSet.resources.directories.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.directories.rulesobject[]No—
project.permissionSet.resources.directories.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.directories.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.directories.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.directories.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.directories.rules[].notestringNoOptional human-readable note for the rule.
project.permissionSet.resources.projectsobjectNo—
project.permissionSet.resources.projects.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.projects.rulesobject[]No—
project.permissionSet.resources.projects.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.projects.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.projects.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.projects.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.projects.rules[].notestringNoOptional human-readable note for the rule.
project.permissionSet.resources.security_repositoriesobjectNo—
project.permissionSet.resources.security_repositories.defaultAccessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.security_repositories.rulesobject[]No—
project.permissionSet.resources.security_repositories.rules[].idstringNoOptional stable rule ID.
project.permissionSet.resources.security_repositories.rules[].targetIdstringNoOptional resource identifier for agent, skill, server, computer, or project rules.
project.permissionSet.resources.security_repositories.rules[].pathstringNoOptional file or directory path for path-scoped rules.
project.permissionSet.resources.security_repositories.rules[].accessfull_access | ask_for_permission | read_only | no_accessNoAccess level for a resource category. `full_access` allows viewing and actions, `ask_for_permission` allows proposed actions that require approval, `read_only` allows viewing without mutation, and `no_access` blocks view and action access.
project.permissionSet.resources.security_repositories.rules[].notestringNoOptional human-readable note for the rule.
project.metadataobjectYesFree-form metadata object.
project.sharedWithMebooleanNo—
project.isSharedbooleanNo—
project.teamSharedbooleanNo—
project.teamShareIdstringNo—
project.teamIdstringNo—
project.teamNamestringNo—
project.teamAccessLeveluse | edit | manageNo—
project.teamShareSourceresource_share | project_settingsNo—
project.summaryobjectNo—
project.createdAtstringYesISO 8601 timestamp.
project.updatedAtstringYesISO 8601 timestamp.
403The authenticated principal is not allowed to perform this actionapplication/json
FieldTypeRequiredDescription
errorstringYes—
messagestringNoMessage text.
codestringNo—
404Resource not foundapplication/json
FieldTypeRequiredDescription
errorstringNo—
Delete project update comment
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow