Edit Post

You can edit a post using a pattern similar to creating a post. Follow these steps:

1. Choose the appropriate post builder type and structure your post.

2. Make the API call for post-editing.

Note: If you intend to update files, images, or videos in a post, you must upload them first. Once you have the data, you can use it with the corresponding post type. Ensure that the builder type matches the original post type.

For further details on uploading, refer to Upload Images Upload FilesUpload Videos.

Update Text Post

To edit a text post, utilize the editPost method in a post repository using AmityTextPostBuilder class to compose a new text as demonstrated in the provided code snippet.

Update File Post

To edit a file post, utilize the editPost method in a post repository using AmityFilePostBuilder class to compose a set of new files as demonstrated in the provided code snippet. The files parameter should include both the current files (if required) and any newly uploaded files you wish to append to the post.

Update Image Post

To edit an image post, utilize the editPost method in a post repository using AmityImagePostBuilder class to compose a set of new images as demonstrated in the provided code snippet. The images parameter should include both the current images (if required) and any newly uploaded images you wish to append to the post.

Update Video Post

To edit a video post, utilize the editPost method in a post repository using AmityVideoPostBuilder class to compose a set of new videos as demonstrated in the provided code snippet. The videos parameter should include both the current videos (if required) and any newly uploaded videos you wish to append to the post.

If you want to edit a file/image/video post to add more files, the files/images to be added must be uploaded first. The AmityFileRepository class handles the uploading and downloading of files. The repository has an uploadFile method which takes the file's Uri and returns an array of AmityUploadResult for successful or failed uploads.

AmityUploadResult will return four possible types of data:

• AmityUploadResult.PROGRESS - uploading is in progress. It returns AmityUploadInfo which can be used to track the progress of the upload.

• AmityUploadResult.COMPLETE - the upload completed successfully. It returns AmityFile that can then be attached to the post.

• AmityUploadResult.ERROR(exception) - the upload failed. It returns an Exception.

• AmityUploadResult.CANCELLED - uploading is canceled.

For further details on uploading, refer to Upload Images Upload FilesUpload Videos.

Update Text Post

Update File Post

To edit a file post, use the edit method as shown in the sample code below. The attachments should contain the uploaded files that you want to add to the post which are stored in existingFiles and newFiles respectively.

Update Image Post

To edit an image post, use the edit method as shown in the sample code below. The attachments should contain the existing images and the uploaded images that you want to add to the post which are stored in existingImages and newImages respectively.

Update Video Post

To edit a video post, use the edit method as shown in the sample code below. The attachments should contain the existing videos and the uploaded videos that you want to add to the post which are stored in existingVideos and newVideos respectively.

This method requires the following parameters:

• postId (String) - ID of the post to update

• data (Object) - data object of the post

Other optional parameters are:

• metadata (Object) - the metadata object of the post

• tags (Array.<String>) - strings used to query the post. Up to five tags can be added and each tag can be up to 24 characters long.

The updatePost method returns a Promise<boolean> - true if the post is successfully updated. Otherwise, it will throw an error.

Update Video Post

You can add new videos or remove existing ones from a video post. In adding new videos, you must first upload the videos that you will add to the post. Refer to Upload Video for the details on how to upload a video.

When updating a video post, provide the file ID of the video and the type FileType.Video in the attachments parameter. Modifying attachments array will overwrite the existing videos so it’s recommended to include original attachments if you want to retain the original videos in the post. Leave the attachments array empty to remove all videos.

import { PostRepository, FileType } from '@amityco/js-sdk';

const post = PostRepository.updatePost({
    postId: 'post123',
    tags: ['a','b'], //optional, max no. tags = 5, max length per tag = 24 chars
    data: { text: 'hello!'},
    mentionees: [
    {
      "type": "user",
      "userIds": [
        "user1", “user2”
      ]
    },
    attachments: [
      { fileId: ‘yourFileId’, type: FileType.Video },
      …
    ]
  ]
});

When updating a post, you can update its text content. However, you cannot add or remove the post's attachments (i.e. image, video, and file).

You can update the post using the update method. This method requires the following parameters:

• postId (String) - ID of the post to update

• text (String) - text data of the post