Delete Posts

Use post deletion when a user or moderator needs to remove a post by ID. Deletion permissions are enforced by the backend according to the actor, target community, and your app settings.

Platform Support

Platform	Soft delete	Hard delete	Public SDK method
TypeScript	Yes	Yes	`PostRepository.softDeletePost(postId)` and `PostRepository.hardDeletePost(postId)`
iOS	Yes	Yes	`softDeletePost(withId:parentId:)` and `hardDeletePost(withId:parentId:)`
Android	Yes	Yes	`softDeletePost(postId)` and `hardDeletePost(postId)`
Flutter	Yes	No verified hard-delete flag	`deletePost(postId:)` or `post.delete()`

Do not rely on Flutter’s hardDelete argument for hard deletion in the current public SDK. The public delete path does not pass a hard-delete flag to the request.

Parameters

Operation	Parameter	Required	Description
Delete a post	`postId`	Yes	Post ID to soft delete or hard delete.
Delete a post	Delete type	Yes	Choose soft delete or hard delete where the target SDK exposes both behaviors.
Delete a post	`parentId`	No	Optional iOS parent post ID for child-post deletion state updates.

Delete a Post

Delete by post ID, choosing soft delete or hard delete only on SDKs that expose the desired behavior.

import { PostRepository } from "@amityco/ts-sdk";

const softDeletedPost = await PostRepository.softDeletePost(postId);
const hardDeletedPost = await PostRepository.hardDeletePost(postId);

renderResults([softDeletedPost, hardDeletedPost]);

try await postRepository.softDeletePost(withId: "post-id", parentId: nil)
try await postRepository.hardDeletePost(withId: "post-id", parentId: nil)

showSuccessMessage()

postRepository.softDeletePost(postId = postId)
    .subscribe(
        { showSuccessMessage(postId) },
        { error -> handleGeneralError(error) }
    )

postRepository.hardDeletePost(postId = postId)
    .subscribe(
        { showSuccessMessage(postId) },
        { error -> handleGeneralError(error) }
    )

await AmitySocialClient.newPostRepository().deletePost(postId: postId);

Parent Post IDs

iOS delete methods accept an optional parentId. Pass nil for top-level posts. If you are deleting a child post and your app already has its parent post ID, pass that parent ID so local post state can be updated correctly.

Notes

Use soft delete when your app needs the deleted state to remain observable.
Use hard delete only when your app intentionally wants the object invalidated or permanently removed on SDKs that expose the hard-delete path.
Refresh or remove local UI items after deletion; live collections usually update, but optimistic UI should still handle delete failures.

Edit Posts

Update existing post content.

Post Review

Approve or decline posts in review queues.

Query Posts

Query posts with deleted-state filters.

Powered by

Getting Started

Fundamentals

Social

Chat

Video

Release Notes

Migration Guides

Support

Platform Support

Parameters

Delete a Post

Parent Post IDs

Notes

Edit Posts

Post Review

Query Posts

​Platform Support

​Parameters

​Delete a Post

​Parent Post IDs

​Notes

​Related Topics

Edit Posts

Post Review

Query Posts

Platform Support

Parameters

Delete a Post

Parent Post IDs

Notes

Related Topics