GET
/
api
/
v1
/
content-histories
Retrieve edit history for content
curl --request GET \
  --url https://apix.us.amity.co/api/v1/content-histories \
  --header 'Authorization: Bearer <token>'
{
  "histories": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "networkId": "network123",
      "contentId": "post456",
      "contentType": "post",
      "version": 1,
      "data": {
        "posts": [
          {
            "_id": "<string>",
            "path": "<string>",
            "postId": "<string>",
            "parentPostId": "<string>",
            "postedUserId": "<string>",
            "postedUserPublicId": "<string>",
            "postedUserInternalId": "<string>",
            "publisherId": "<string>",
            "publisherPublicId": "<string>",
            "sharedUserId": "<string>",
            "sharedCount": 123,
            "targetId": "<string>",
            "targetPublicId": "<string>",
            "targetInternalId": "<string>",
            "targetType": "user",
            "dataType": "text",
            "data": {
              "title": "<string>",
              "text": "<string>",
              "fileId": "<string>",
              "thumbnailFileId": "<string>",
              "videoFileId": {
                "original": "<string>",
                "low": "<string>",
                "medium": "<string>",
                "high": "<string>"
              },
              "streamId": "<string>"
            },
            "metadata": {},
            "flagCount": 123,
            "hashFlag": {
              "bits": 123,
              "hashes": 123,
              "hash": [
                "<string>"
              ]
            },
            "editedAt": "2023-11-07T05:31:56Z",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "reactions": {
              "like": 1
            },
            "reactionsCount": 1,
            "myReactions": [
              "like"
            ],
            "commentsCount": 1,
            "comments": [
              "<string>"
            ],
            "children": [
              "<string>"
            ],
            "childrenNumber": 123,
            "isDeleted": false,
            "hasFlaggedComment": false,
            "hasFlaggedChildren": false,
            "feedId": "<string>",
            "tags": [
              "<string>"
            ],
            "hashtags": [
              "video_content",
              "clips_feature",
              "multimedia_posts",
              "next_gen_social"
            ],
            "mentionees": [
              {
                "type": "user",
                "userIds": [
                  "<string>"
                ],
                "userPublicIds": [
                  "<string>"
                ],
                "userInternalIds": [
                  "<string>"
                ]
              }
            ],
            "impression": 123,
            "reach": 123
          }
        ],
        "postChildren": [
          {
            "_id": "<string>",
            "path": "<string>",
            "postId": "<string>",
            "parentPostId": "<string>",
            "postedUserId": "<string>",
            "postedUserPublicId": "<string>",
            "postedUserInternalId": "<string>",
            "publisherId": "<string>",
            "publisherPublicId": "<string>",
            "sharedUserId": "<string>",
            "sharedCount": 123,
            "targetId": "<string>",
            "targetPublicId": "<string>",
            "targetInternalId": "<string>",
            "targetType": "user",
            "dataType": "text",
            "data": {
              "title": "<string>",
              "text": "<string>",
              "fileId": "<string>",
              "thumbnailFileId": "<string>",
              "videoFileId": {
                "original": "<string>",
                "low": "<string>",
                "medium": "<string>",
                "high": "<string>"
              },
              "streamId": "<string>"
            },
            "metadata": {},
            "flagCount": 123,
            "hashFlag": {
              "bits": 123,
              "hashes": 123,
              "hash": [
                "<string>"
              ]
            },
            "editedAt": "2023-11-07T05:31:56Z",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "reactions": {
              "like": 1
            },
            "reactionsCount": 1,
            "myReactions": [
              "like"
            ],
            "commentsCount": 1,
            "comments": [
              "<string>"
            ],
            "children": [
              "<string>"
            ],
            "childrenNumber": 123,
            "isDeleted": false,
            "hasFlaggedComment": false,
            "hasFlaggedChildren": false,
            "feedId": "<string>",
            "tags": [
              "<string>"
            ],
            "hashtags": [
              "mobile_app",
              "user_experience",
              "API_v4",
              "social_platform"
            ],
            "mentionees": [
              {
                "type": "user",
                "userIds": [
                  "<string>"
                ],
                "userPublicIds": [
                  "<string>"
                ],
                "userInternalIds": [
                  "<string>"
                ]
              }
            ],
            "impression": 123,
            "reach": 123
          }
        ],
        "comments": [
          {
            "_id": "<string>",
            "path": "<string>",
            "commentId": "<string>",
            "userId": "<string>",
            "userPublicId": "<string>",
            "userInternalId": "<string>",
            "parentId": "<string>",
            "rootId": "<string>",
            "referenceId": "<string>",
            "referenceType": "post",
            "dataType": "<string>",
            "dataTypes": [
              "text"
            ],
            "data": {},
            "metadata": {},
            "childrenNumber": 123,
            "flagCount": 123,
            "hashFlag": {
              "bits": 123,
              "hashes": 123,
              "hash": [
                "<string>"
              ]
            },
            "reactions": {
              "like": 1
            },
            "reactionsCount": 1,
            "myReactions": [
              "like"
            ],
            "isDeleted": false,
            "editedAt": "2023-11-07T05:31:56Z",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "children": [
              "<string>"
            ],
            "segmentNumber": 1,
            "mentionees": [
              {
                "type": "user",
                "userIds": [
                  "<string>"
                ],
                "userPublicIds": [
                  "<string>"
                ],
                "userInternalIds": [
                  "<string>"
                ]
              }
            ],
            "attachments": [
              {
                "type": "image",
                "fileId": "<string>"
              }
            ],
            "targetId": "<string>",
            "targetType": "community"
          }
        ],
        "users": [
          {
            "_id": "<string>",
            "path": "<string>",
            "userId": "<string>",
            "userInternalId": "<string>",
            "userPublicId": "<string>",
            "roles": [
              "<string>"
            ],
            "permissions": [
              "MUTE_CHANNEL"
            ],
            "displayName": "<string>",
            "profileHandle": "<string>",
            "description": "<string>",
            "avatarFileId": "<string>",
            "avatarCustomUrl": "<string>",
            "flagCount": 123,
            "hashFlag": {
              "bits": 123,
              "hashes": 123,
              "hash": [
                "<string>"
              ]
            },
            "metadata": {},
            "isGlobalBan": true,
            "isBrand": true,
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "isDeleted": true
          }
        ],
        "roles": [
          {
            "roleId": "<string>",
            "displayName": "<string>",
            "updatedAt": "2023-11-07T05:31:56Z",
            "createdAt": "2023-11-07T05:31:56Z",
            "permissions": [
              "<string>"
            ],
            "isDeleted": false
          }
        ],
        "files": [
          {
            "fileId": "<string>",
            "fileUrl": "<string>",
            "type": "image",
            "accessType": "public",
            "altText": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "attributes": {
              "name": "<string>",
              "extension": "<string>",
              "size": 123,
              "mimeType": "<string>",
              "metadata": {
                "exif": {},
                "gps": {},
                "height": 123,
                "width": 123,
                "isFull": true
              }
            }
          }
        ],
        "communities": [
          {
            "_id": "<string>",
            "path": "<string>",
            "communityId": "<string>",
            "channelId": "<string>",
            "userId": "<string>",
            "userPublicId": "<string>",
            "userInternalId": "<string>",
            "displayName": "<string>",
            "avatarFileId": "<string>",
            "description": "<string>",
            "isOfficial": true,
            "isPublic": true,
            "onlyAdminCanPost": true,
            "tags": [
              "<string>"
            ],
            "metadata": {},
            "postsCount": 123,
            "membersCount": 123,
            "isJoined": true,
            "categoryIds": [
              "<string>"
            ],
            "isDeleted": false,
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "hasFlaggedComment": false,
            "hasFlaggedPost": false,
            "needApprovalOnPostCreation": false,
            "moderatorMemberCount": 123,
            "allowCommentInStory": true,
            "isDiscoverable": false,
            "requiresJoinApproval": false,
            "notificationMode": "default"
          }
        ],
        "communityUsers": [
          {
            "userId": "<string>",
            "userPublicId": "<string>",
            "userInternalId": "<string>",
            "channelId": "<string>",
            "communityId": "<string>",
            "communityMembership": "none",
            "notMemberReason": "<string>",
            "isBanned": false,
            "lastActivity": "2023-11-07T05:31:56Z",
            "roles": [
              "<string>"
            ],
            "permissions": [
              "MUTE_CHANNEL"
            ],
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "categories": [
          {
            "categoryId": "<string>",
            "name": "<string>",
            "metadata": {},
            "avatarFileId": "<string>",
            "isDeleted": false,
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "feeds": [
          {
            "targetId": "<string>",
            "targetType": "community",
            "postCount": 123,
            "feedType": "published",
            "feedId": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "videoStreamings": [
          {
            "streamId": "<string>",
            "userId": "<string>",
            "userInternalId": "64be1f6cb9b4106b5a6bbf3f",
            "userPublicId": "User123",
            "thumbnailFileId": "<string>",
            "title": "<string>",
            "status": "idle",
            "isLive": true,
            "isDeleted": true,
            "description": "<string>",
            "platform": {
              "name": "<string>",
              "version": "<string>"
            },
            "moderationId": "<string>",
            "startedAt": "2023-11-07T05:31:56Z",
            "endedAt": "2023-11-07T05:31:56Z",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "metadata": {},
            "resolution": "SD",
            "streamerUrl": {
              "url": "<string>",
              "components": {
                "origin": "<string>",
                "appName": "<string>",
                "streamName": "<string>",
                "query": "<string>"
              }
            },
            "recordings": [
              {
                "flv": {
                  "url": "<string>",
                  "duration": 123,
                  "startTime": 123,
                  "stopTime": 123
                },
                "mp4": {
                  "url": "<string>",
                  "duration": 123,
                  "startTime": 123,
                  "stopTime": 123
                },
                "m3u8": {
                  "url": "<string>",
                  "duration": 123,
                  "startTime": 123,
                  "stopTime": 123
                }
              }
            ],
            "watcherUrl": {
              "flv": {
                "url": "<string>",
                "components": {
                  "origin": "<string>",
                  "appName": "<string>",
                  "streamName": "<string>",
                  "query": "<string>"
                }
              },
              "hls": {
                "url": "<string>",
                "components": {
                  "origin": "<string>",
                  "appName": "<string>",
                  "streamName": "<string>",
                  "query": "<string>"
                }
              },
              "rtmp": {
                "url": "<string>",
                "components": {
                  "origin": "<string>",
                  "appName": "<string>",
                  "streamName": "<string>",
                  "query": "<string>"
                }
              }
            },
            "postId": "<string>",
            "channelId": "<string>",
            "channelEnabled": true,
            "isParent": false,
            "parentStreamId": "<string>",
            "childStreamIds": []
          }
        ],
        "videoStreamingChildren": [
          {
            "streamId": "<string>",
            "userId": "<string>",
            "userInternalId": "64be1f6cb9b4106b5a6bbf3f",
            "userPublicId": "User123",
            "thumbnailFileId": "<string>",
            "title": "<string>",
            "status": "idle",
            "isLive": true,
            "isDeleted": true,
            "description": "<string>",
            "platform": {
              "name": "<string>",
              "version": "<string>"
            },
            "moderationId": "<string>",
            "startedAt": "2023-11-07T05:31:56Z",
            "endedAt": "2023-11-07T05:31:56Z",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "metadata": {},
            "resolution": "SD",
            "streamerUrl": {
              "url": "<string>",
              "components": {
                "origin": "<string>",
                "appName": "<string>",
                "streamName": "<string>",
                "query": "<string>"
              }
            },
            "recordings": [
              {
                "flv": {
                  "url": "<string>",
                  "duration": 123,
                  "startTime": 123,
                  "stopTime": 123
                },
                "mp4": {
                  "url": "<string>",
                  "duration": 123,
                  "startTime": 123,
                  "stopTime": 123
                },
                "m3u8": {
                  "url": "<string>",
                  "duration": 123,
                  "startTime": 123,
                  "stopTime": 123
                }
              }
            ],
            "watcherUrl": {
              "flv": {
                "url": "<string>",
                "components": {
                  "origin": "<string>",
                  "appName": "<string>",
                  "streamName": "<string>",
                  "query": "<string>"
                }
              },
              "hls": {
                "url": "<string>",
                "components": {
                  "origin": "<string>",
                  "appName": "<string>",
                  "streamName": "<string>",
                  "query": "<string>"
                }
              },
              "rtmp": {
                "url": "<string>",
                "components": {
                  "origin": "<string>",
                  "appName": "<string>",
                  "streamName": "<string>",
                  "query": "<string>"
                }
              }
            },
            "postId": "<string>",
            "channelId": "<string>",
            "channelEnabled": true,
            "isParent": false,
            "parentStreamId": "<string>",
            "childStreamIds": []
          }
        ],
        "polls": [
          {
            "pollId": "<string>",
            "userId": "<string>",
            "userInternalId": "64be1f6cb9b4106b5a6bbf3f",
            "userPublicId": "User123",
            "title": "<string>",
            "question": "<string>",
            "answers": [
              {
                "dataType": "text",
                "data": "<string>",
                "fileId": "<string>",
                "voteCount": 0,
                "isVotedByUser": false,
                "id": "<string>"
              }
            ],
            "answerType": "<string>",
            "closedAt": "<string>",
            "createdAt": "<string>",
            "isVoted": false,
            "status": "open",
            "closedIn": 123
          }
        ]
      },
      "editedBy": "admin123",
      "editedAt": "2025-01-15T10:30:00Z",
      "editReason": "Fixed spelling error",
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-15T10:30:00Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

contentId
string
required

The public ID of the content (post or comment)

contentType
enum<string>
required

The type of content

Available options:
post,
comment

Response

Content edit history retrieved successfully

histories
object[]