Post

Post is one of the most important content item in HiveSocial. Posts are created by group members to share or discuss ideas, news and etc.

Method: list

Authorization is required. Post are ordered in reversed chronological order.

Request

HTTP request

GET https://<YOUR_DOMAIN>/api/v1/en_US/post/list/{groupId}?offset={offset}&pageSize={pageSize}&filter={filter}

Parameters

propertyvaluedescription
groupId guid The posts group's ID
offset integer Needed for the infinite scroll functionality. It is the ID of the last presented item to the user. After the request list is generated the system will skip all records from the beginning up to the record with the provided ID (including it). The next batch of records will be returned in the response.
pageSize integer How many records to be returned by the system. Usually 15
filter string Query string to be looked for when filtering the records

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
  "success": true,
  "message": "Aliqua ullamco deserunt velit eiusmod laboris labore voluptate sunt cillum proident enim.",
  "timestamp": "2014-03-03T23:20:23Z",
  "errors": [],
  "object": {
    "offset": "bf039f10-323c-4f98-94df-5eede02c69b4",
    "posts": [
      {
        "id": "40082a31-8f43-4892-b3ab-e48a6effbcb9",
        "type": "post",
        "group": {
          "id": "e532e792-4101-4ef5-8cd7-68380bbbc703",
          "name": "Home",
          "slug": "Home",
          "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
          "url": "http://demo.hivesocialnow.com/Home/"
        },
        "createdOn": "2014-03-03T23:20:23Z",
        "author": {
          "id": "b3f5355c-4643-4c12-98d4-0d4aed216691",
          "alias": "cillum sint",
          "extendedAlias": "culpa culpa dolor elit aliquip",
          "slug": "Home",
          "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
          "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
        },
        "approvedOn": "2014-03-03T23:20:23Z",
        "title": "Incididunt ullamco amet anim est adipisicing adipisicing consequat aliquip ad ipsum do qui.",
        "summary": "Ea magna amet ipsum dolore fugiat dolore.",
        "content": "Cupidatat voluptate adipisicing reprehenderit excepteur do dolore et sunt voluptate commodo deserunt esse adipisicing. ",
        "slug": "1",
        "url": "http://demo.hivesocialnow.com/Home/posts/123",
        "views": 10790,
        "rating": 1,
        "votes": 3,
        "bookmarks": 12,
        "comments": 3,
        "spamReports": 16,
        "isApproved": true,
        "isPromoted": false,
        "canComment": true,
        "isAnonymous": false,
        "typeId": 15,
        "typeName": "Commodo culpa dolore magna tempor.",
        "statusId": 2,
        "statusName": "Escalated",
        "isDraft": false,
        "tags": [
          {
            "id": 1,
            "name": "id"
          },
          {
            "id": 2,
            "name": "aliqua"
          }
        ],
        "cateogries": [
          {
            "id": 1,
            "name": "est"
          },
          {
            "id": 2,
            "name": "eiusmod"
          }
        ],
        "accessWarnings": []
      }
    ]
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: unapproved list

Authorization is required. This methods return only posts that have unapproved status. Post are ordered in reversed chronological order.

Request

HTTP request

GET https://<YOUR_DOMAIN>/api/v1/en_US/post/list/{groupId}/unapproved?offset={offset}&pageSize={pageSize}

Parameters

propertyvaluedescription
groupId guid The posts group's ID
offset integer Needed for the infinite scroll functionality. It is the ID of the last presented item to the user. After the request list is generated the system will skip all records from the beginning up to the record with the provided ID (including it). The next batch of records will be returned in the response.
pageSize integer How many records to be returned by the system. Usually 15

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
  "success": true,
  "message": "Aliqua ullamco deserunt velit eiusmod laboris labore voluptate sunt cillum proident enim.",
  "timestamp": "2014-03-03T23:20:23Z",
  "errors": [],
  "object": {
    "offset": "bf039f10-323c-4f98-94df-5eede02c69b4",
    "posts": [
      {
        "id": "40082a31-8f43-4892-b3ab-e48a6effbcb9",
        "type": "post",
        "group": {
          "id": "e532e792-4101-4ef5-8cd7-68380bbbc703",
          "name": "Home",
          "slug": "Home",
          "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
          "url": "http://demo.hivesocialnow.com/Home/"
        },
        "createdOn": "2014-03-03T23:20:23Z",
        "author": {
          "id": "b3f5355c-4643-4c12-98d4-0d4aed216691",
          "alias": "cillum sint",
          "extendedAlias": "culpa culpa dolor elit aliquip",
          "slug": "Home",
          "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
          "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
        },
        "approvedOn": "2014-03-03T23:20:23Z",
        "title": "Incididunt ullamco amet anim est adipisicing adipisicing consequat aliquip ad ipsum do qui.",
        "summary": "Ea magna amet ipsum dolore fugiat dolore.",
        "content": "Cupidatat voluptate adipisicing reprehenderit excepteur do dolore et sunt voluptate commodo deserunt esse adipisicing. ",
        "slug": "1",
        "url": "http://demo.hivesocialnow.com/Home/posts/123",
        "views": 10790,
        "rating": 1,
        "votes": 3,
        "bookmarks": 12,
        "comments": 3,
        "spamReports": 16,
        "isApproved": false,
        "isPromoted": false,
        "canComment": true,
        "isAnonymous": false,
        "typeId": 15,
        "typeName": "Commodo culpa dolore magna tempor.",
        "statusId": 2,
        "statusName": "Escalated",
        "isDraft": false,
        "tags": [
          {
            "id": 1,
            "name": "id"
          },
          {
            "id": 2,
            "name": "aliqua"
          }
        ],
        "cateogries": [
          {
            "id": 1,
            "name": "est"
          },
          {
            "id": 2,
            "name": "eiusmod"
          }
        ],
        "accessWarnings": []
      }
    ]
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: delete

Authorization is required.

Request

HTTP request

DELETE https://<YOUR_DOMAIN>/api/v1/en_US/post/{postId}

Parameters

propertyvaluedescription
postId integer In id of the deleted record

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
  "success": true,
  "message": "Eu in dolore consectetur id eiusmod quis officia.",
  "timestamp": "2014-03-03T23:20:23Z",
  "errors": [],
  "object": {
    "id": "c7fb1cc6-1b67-43e3-969b-ddf4a05442b9",
    "type": "post",
    "group": {
      "id": "83e89cd1-125d-4cee-bd65-6208fe82e341",
      "name": "adipisicing",
      "slug": "Home",
      "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
      "url": "http://demo.hivesocialnow.com/Home/"
    },
    "createdOn": "2014-03-03T23:20:23Z",
    "author": {
      "id": "6b05b94e-e7c6-4bab-9377-e89ae1651425",
      "alias": "labore labore",
      "extendedAlias": "aute commodo eiusmod nisi labore",
      "slug": "Home",
      "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
      "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
    },
    "approvedOn": "2014-03-03T23:20:23Z",
    "title": "Ex non consectetur eu elit dolor enim.",
    "summary": "Quis consectetur adipisicing cillum sint reprehenderit sint consectetur sit voluptate irure nisi.",
    "content": "Reprehenderit aliquip velit cillum nulla ut anim cupidatat minim amet labore non ea.",
    "slug": "1",
    "url": "http://demo.hivesocialnow.com/Home/posts/123",
    "views": 12981,
    "rating": 1,
    "votes": 3,
    "bookmarks": 11,
    "comments": 9,
    "spamReports": 8,
    "isApproved": false,
    "isPromoted": false,
    "canComment": false,
    "isAnonymous": false,
    "typeId": 10,
    "typeName": "Excepteur non commodo nostrud Lorem exercitation ipsum nulla ipsum esse reprehenderit.",
    "statusId": 4,
    "statusName": "Reopened",
    "isDraft": false,
    "tags": [
      {
        "id": 1,
        "name": "minim"
      },
      {
        "id": 2,
        "name": "non"
      }
    ],
    "cateogries": [
      {
        "id": 1,
        "name": "veniam"
      },
      {
        "id": 2,
        "name": "laborum"
      }
    ],
    "accessWarnings": []
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

propertyvaluedescription
success Boolean Whether the requested operation is successful or not
message String Human readable error information
errors List (object) This list very rarely contains records during delete method processing
object object The object that was deleted

Method: delete all unapproved

Authorization is required.

Request

HTTP request

DELETE https://<YOUR_DOMAIN>/api/v1/en_US/post/list/{groupId}/unapproved

Parameters

propertyvaluedescription
groupId guid The group id for which you want to delete all unapproved posts.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
	"timestamp": "2014-03-03T23:20:23Z",	
	"success": true,
	"message": "Aliqua anim consequat amet cupidatat proident amet amet.",
	"errors":[],
	"object": {}
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: approve post

Authorization is required.

Request

HTTP request

POST https://<YOUR_DOMAIN>/api/v1/en_US/post/{postId}/approve

Parameters

Do not supply a request parameters with this method.

Request body

propertyvaluedescription
postId guid The id of the post you need to approve

Response

If successful, this method returns a response JSON with the following structure:

{
  "timestamp": "2014-03-03T23:20:23Z",
  "success": true,
  "message": "Aliqua anim consequat amet cupidatat proident amet amet.",
  "errors": [],
  "object": {
    "id": "c7fb1cc6-1b67-43e3-969b-ddf4a05442b9",
    "type": "post",
    "group": {
      "id": "83e89cd1-125d-4cee-bd65-6208fe82e341",
      "name": "adipisicing",
      "slug": "Home",
      "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
      "url": "http://demo.hivesocialnow.com/Home/"
    },
    "createdOn": "2014-03-03T23:20:23Z",
    "author": {
      "id": "6b05b94e-e7c6-4bab-9377-e89ae1651425",
      "alias": "labore labore",
      "extendedAlias": "aute commodo eiusmod nisi labore",
      "slug": "Home",
      "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
      "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
    },
    "approvedOn": "2014-03-03T23:20:23Z",
    "title": "Ex non consectetur eu elit dolor enim.",
    "summary": "Quis consectetur adipisicing cillum sint reprehenderit sint",
    "content": "Reprehenderit aliquip velit cillum nulla ut anim cupidatat minim amet labore non ea.",
    "slug": "1",
    "url": "http://demo.hivesocialnow.com/Home/posts/123",
    "views": 12981,
    "rating": 1,
    "votes": 3,
    "bookmarks": 11,
    "comments": 9,
    "spamReports": 8,
    "isApproved": true,
    "isPromoted": false,
    "canComment": false,
    "isAnonymous": false,
    "typeId": 10,
    "typeName": "Excepteur non commodo nostrud Lorem exercitation ipsum nulla ipsum esse reprehenderit.",
    "statusId": 4,
    "statusName": "Reopened",
    "isDraft": false,
    "tags": [
      {
        "id": 1,
        "name": "minim"
      },
      {
        "id": 2,
        "name": "non"
      }
    ],
    "cateogries": [
      {
        "id": 1,
        "name": "veniam"
      },
      {
        "id": 2,
        "name": "laborum"
      }
    ],
    "accessWarnings": []
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

propertyvaluedescription
success Boolean Whether the requested operation is successful or not
message String Human readable error information
errors List (object) List of validation errors, if any. The "key" property value is matched to one of the record's fields
object object The updated post object

Method: post spam reports list

Authorization is required. Post are ordered in reversed chronological order. Only posts with spam reports for them are returned

Request

HTTP request

GET https://<YOUR_DOMAIN>/api/v1/en_US/post/list/{groupId}/spam-reports?offset={offset}&pageSize={pageSize}

Parameters

propertyvaluedescription
groupId guid The posts group's ID
offset integer Needed for the infinite scroll functionality. It is the ID of the last presented item to the user. After the request list is generated the system will skip all records from the beginning up to the record with the provided ID (including it). The next batch of records will be returned in the response.
pageSize integer How many records to be returned by the system. Usually 15

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
  "success": true,
  "message": "Aute ex commodo irure ex veniam ex irure ea quis sit ullamco eiusmod enim elit.",
  "timestamp": "2014-03-03T23:20:23Z",
  "errors": [],
  "object": {
    "offset": "bf039f10-323c-4f98-94df-5eede02c69b4",
    "posts": [
      {
        "id": "bf039f10-323c-4f98-94df-5eede02c69b4",
        "type": "post",
        "group": {
          "id": "2f2b5976-14c5-452d-b6f9-4f6b3b9a2d24",
          "name": "Lorem",
          "slug": "Home",
          "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
          "url": "http://demo.hivesocialnow.com/Home/"
        },
        "createdOn": "2014-03-03T23:20:23Z",
        "author": {
          "id": "ff0c1aca-a8f1-43bf-91ff-074c171e73af",
          "alias": "id sunt",
          "extendedAlias": "consequat dolore laboris deserunt duis",
          "slug": "Home",
          "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
          "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
        },
        "approvedOn": "2014-03-03T23:20:23Z",
        "title": "Aliquip dolor esse adipisicing enim voluptate minim officia.",
        "summary": "Commodo aliqua aliqua ut cupidatat occaecat officia consequat dolore consequat qui exercitation eu.",
        "content": "Laborum nostrud voluptate sunt quis. Nulla aliquip do reprehenderit anim irure eu. ",
        "slug": "1",
        "url": "http://demo.hivesocialnow.com/Home/posts/123",
        "reports": [
          {
            "createdOn": "2014-03-23T23:20:23Z",
            "author": {
              "id": "c39b42bf-5c9c-424f-a645-5a20b2517842",
              "alias": "proident cillum 1",
              "extendedAlias": "commodo pariatur nostrud nulla in",
              "slug": "Home",
              "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
              "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
            }
          }
        ],
        "accessWarnings": []
      }
    ]
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: delete post spam reports

Authorization is required. This method will purge all post's spam reports

Request

HTTP request

DELETE https://<YOUR_DOMAIN>/api/v1/en_US/post/{postId}/spam-reports

Parameters

propertyvaluedescription
postId integer In id of the post for which you need to delete all spam reports

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
  "timestamp": "2014-03-03T23:20:23Z",
  "success": true,
  "message": "Aliqua anim consequat amet cupidatat proident amet amet.",
  "errors": [],
  "object": 
       {
        "id": "bf039f10-323c-4f98-94df-5eede02c69b4",
        "type": "post",
        "group": {
          "id": "2f2b5976-14c5-452d-b6f9-4f6b3b9a2d24",
          "name": "Lorem",
          "slug": "Home",
          "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
          "url": "http://demo.hivesocialnow.com/Home/"
        },
        "createdOn": "2014-03-03T23:20:23Z",
        "author": {
          "id": "ff0c1aca-a8f1-43bf-91ff-074c171e73af",
          "alias": "id sunt",
          "extendedAlias": "consequat dolore laboris deserunt duis",
          "slug": "Home",
          "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
          "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
        },
        "approvedOn": "2014-03-03T23:20:23Z",
        "title": "Aliquip dolor esse adipisicing enim voluptate minim officia.",
        "summary": "Commodo aliqua aliqua ut cupidatat occaecat officia consequat dolore consequat qui exercitation eu.",
        "content": "Laborum nostrud voluptate sunt quis. Nulla aliquip do reprehenderit anim irure eu. ",
        "slug": "1",
        "url": "http://demo.hivesocialnow.com/Home/posts/123",
        "reports": [],
        "accessWarnings": []
      }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: deleted list

Authorization is required. Post are ordered in reversed chronological order by deletion date. In HiveSocial delete method is only hiding the posts from the public, but it is kept in the database until it is purged.

Request

HTTP request

GET https://<YOUR_DOMAIN>/api/v1/en_US/post/list/{groupId}/deleted?offset={offset}&pageSize={pageSize}

Parameters

propertyvaluedescription
groupId guid The posts group's ID
offset integer Needed for the infinite scroll functionality. It is the ID of the last presented item to the user. After the request list is generated the system will skip all records from the beginning up to the record with the provided ID (including it). The next batch of records will be returned in the response.
pageSize integer How many records to be returned by the system. Usually 15

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
  "success": true,
  "message": "Aliqua ullamco deserunt velit eiusmod laboris labore voluptate sunt cillum proident enim.",
  "timestamp": "2014-03-03T23:20:23Z",
  "errors": [],
  "object": {
    "offset": "bf039f10-323c-4f98-94df-5eede02c69b4",
    "posts": [
      {
        "id": "40082a31-8f43-4892-b3ab-e48a6effbcb9",
        "type": "post",
        "group": {
          "id": "e532e792-4101-4ef5-8cd7-68380bbbc703",
          "name": "Home",
          "slug": "Home",
          "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
          "url": "http://demo.hivesocialnow.com/Home/"
        },
        "createdOn": "2014-03-03T23:20:23Z",
        "author": {
          "id": "b3f5355c-4643-4c12-98d4-0d4aed216691",
          "alias": "cillum sint",
          "extendedAlias": "culpa culpa dolor elit aliquip",
          "slug": "Home",
          "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
          "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
        },
        "approvedOn": "2014-03-03T23:20:23Z",
        "title": "Incididunt ullamco amet anim est adipisicing adipisicing consequat aliquip ad ipsum do qui.",
        "summary": "Ea magna amet ipsum dolore fugiat dolore.",
        "content": "Cupidatat voluptate adipisicing reprehenderit excepteur do dolore et sunt voluptate commodo deserunt esse adipisicing. ",
        "slug": "1",
        "url": "http://demo.hivesocialnow.com/Home/posts/123",
        "views": 10790,
        "rating": 1,
        "votes": 3,
        "bookmarks": 12,
        "comments": 3,
        "spamReports": 16,
        "isApproved": false,
        "isPromoted": false,
        "canComment": true,
        "isAnonymous": false,
        "typeId": 15,
        "typeName": "Commodo culpa dolore magna tempor.",
        "statusId": 2,
        "statusName": "Escalated",
        "isDraft": false,
        "tags": [
          {
            "id": 1,
            "name": "id"
          },
          {
            "id": 2,
            "name": "aliqua"
          }
        ],
        "cateogries": [
          {
            "id": 1,
            "name": "est"
          },
          {
            "id": 2,
            "name": "eiusmod"
          }
        ],
        "accessWarnings": []
      }
    ]
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: undelete post

Authorization is required.

Request

HTTP request

POST https://<YOUR_DOMAIN>/api/v1/en_US/post/{postId}/undelete

Parameters

Do not supply a request parameters with this method.

Request body

propertyvaluedescription
postId guid The id of the post you need to undelete

Response

If successful, this method returns a response JSON with the following structure:

{
  "timestamp": "2014-03-03T23:20:23Z",
  "success": true,
  "message": "Aliqua anim consequat amet cupidatat proident amet amet.",
  "errors": [],
  "object": {
    "id": "c7fb1cc6-1b67-43e3-969b-ddf4a05442b9",
    "type": "post",
    "group": {
      "id": "83e89cd1-125d-4cee-bd65-6208fe82e341",
      "name": "adipisicing",
      "slug": "Home",
      "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
      "url": "http://demo.hivesocialnow.com/Home/"
    },
    "createdOn": "2014-03-03T23:20:23Z",
    "author": {
      "id": "6b05b94e-e7c6-4bab-9377-e89ae1651425",
      "alias": "labore labore",
      "extendedAlias": "aute commodo eiusmod nisi labore",
      "slug": "Home",
      "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
      "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
    },
    "approvedOn": "2014-03-03T23:20:23Z",
    "title": "Ex non consectetur eu elit dolor enim.",
    "summary": "Quis consectetur adipisicing cillum sint reprehenderit sint",
    "content": "Reprehenderit aliquip velit cillum nulla ut anim cupidatat minim amet labore non ea.",
    "slug": "1",
    "url": "http://demo.hivesocialnow.com/Home/posts/123",
    "views": 12981,
    "rating": 1,
    "votes": 3,
    "bookmarks": 11,
    "comments": 9,
    "spamReports": 8,
    "isApproved": true,
    "isPromoted": false,
    "canComment": false,
    "isAnonymous": false,
    "typeId": 10,
    "typeName": "Excepteur non commodo nostrud Lorem exercitation ipsum nulla ipsum esse reprehenderit.",
    "statusId": 4,
    "statusName": "Reopened",
    "isDraft": false,
    "tags": [
      {
        "id": 1,
        "name": "minim"
      },
      {
        "id": 2,
        "name": "non"
      }
    ],
    "cateogries": [
      {
        "id": 1,
        "name": "veniam"
      },
      {
        "id": 2,
        "name": "laborum"
      }
    ],
    "accessWarnings": []
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: purge post

Authorization is required. Only deleted post can be purged

Request

HTTP request

POST https://<YOUR_DOMAIN>/api/v1/en_US/post/{postId}/purge

Parameters

Do not supply a request parameters with this method.

Request body

propertyvaluedescription
postId guid The id of the post you need to purge

Response

If successful, this method returns a response JSON with the following structure:

{
  "timestamp": "2014-03-03T23:20:23Z",
  "success": true,
  "message": "Aliqua anim consequat amet cupidatat proident amet amet.",
  "errors": [],
  "object": {
    "id": "c7fb1cc6-1b67-43e3-969b-ddf4a05442b9",
    "type": "post",
    "group": {
      "id": "83e89cd1-125d-4cee-bd65-6208fe82e341",
      "name": "adipisicing",
      "slug": "Home",
      "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
      "url": "http://demo.hivesocialnow.com/Home/"
    },
    "createdOn": "2014-03-03T23:20:23Z",
    "author": {
      "id": "6b05b94e-e7c6-4bab-9377-e89ae1651425",
      "alias": "labore labore",
      "extendedAlias": "aute commodo eiusmod nisi labore",
      "slug": "Home",
      "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
      "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
    },
    "approvedOn": "2014-03-03T23:20:23Z",
    "title": "Ex non consectetur eu elit dolor enim.",
    "summary": "Quis consectetur adipisicing cillum sint reprehenderit sint",
    "content": "Reprehenderit aliquip velit cillum nulla ut anim cupidatat minim amet labore non ea.",
    "slug": "1",
    "url": "http://demo.hivesocialnow.com/Home/posts/123",
    "views": 12981,
    "rating": 1,
    "votes": 3,
    "bookmarks": 11,
    "comments": 9,
    "spamReports": 8,
    "isApproved": true,
    "isPromoted": false,
    "canComment": false,
    "isAnonymous": false,
    "typeId": 10,
    "typeName": "Excepteur non commodo nostrud Lorem exercitation ipsum nulla ipsum esse reprehenderit.",
    "statusId": 4,
    "statusName": "Reopened",
    "isDraft": false,
    "tags": [
      {
        "id": 1,
        "name": "minim"
      },
      {
        "id": 2,
        "name": "non"
      }
    ],
    "cateogries": [
      {
        "id": 1,
        "name": "veniam"
      },
      {
        "id": 2,
        "name": "laborum"
      }
    ],
    "accessWarnings": []
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: delete all unapproved

Authorization is required.

Request

HTTP request

POST https://<YOUR_DOMAIN>/api/v1/en_US/post/purge-deleted/group/{groupId}

Parameters

propertyvaluedescription
groupId guid The group id for which you want to purge all unapproved posts.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response JSON with the following structure:

{
	"timestamp": "2014-03-03T23:20:23Z",	
	"success": true,
	"message": "Aliqua anim consequat amet cupidatat proident amet amet.",
	"errors":[],
	"object": {}
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

Method: copy post

Authorization is required.

Request

HTTP request

POST https://<YOUR_DOMAIN>/api/v1/en_US/post/{postId}/copy

Parameters

Do not supply a request parameters with this method.

Request body

propertyvaluedescription
postId guid The id of the post you need to copy

Response

propertyvaluedescription
groupId guid The group that you need to copy this post to
{
  "timestamp": "2014-03-03T23:20:23Z",
  "success": true,
  "message": "Aliqua anim consequat amet cupidatat proident amet amet.",
  "errors": [],
  "object": {
    "id": "c7fb1cc6-1b67-43e3-969b-ddf4a05442b9",
    "type": "post",
    "group": {
      "id": "83e89cd1-125d-4cee-bd65-6208fe82e341",
      "name": "adipisicing",
      "slug": "Home",
      "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
      "url": "http://demo.hivesocialnow.com/Home/"
    },
    "createdOn": "2014-03-03T23:20:23Z",
    "author": {
      "id": "6b05b94e-e7c6-4bab-9377-e89ae1651425",
      "alias": "labore labore",
      "extendedAlias": "aute commodo eiusmod nisi labore",
      "slug": "Home",
      "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
      "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
    },
    "approvedOn": "2014-03-03T23:20:23Z",
    "title": "Ex non consectetur eu elit dolor enim.",
    "summary": "Quis consectetur adipisicing cillum sint reprehenderit sint",
    "content": "Reprehenderit aliquip velit cillum nulla ut anim cupidatat minim amet labore non ea.",
    "slug": "1",
    "url": "http://demo.hivesocialnow.com/Home/posts/123",
    "views": 12981,
    "rating": 1,
    "votes": 3,
    "bookmarks": 11,
    "comments": 9,
    "spamReports": 8,
    "isApproved": true,
    "isPromoted": false,
    "canComment": false,
    "isAnonymous": false,
    "typeId": 10,
    "typeName": "Excepteur non commodo nostrud Lorem exercitation ipsum nulla ipsum esse reprehenderit.",
    "statusId": 4,
    "statusName": "Reopened",
    "isDraft": false,
    "tags": [
      {
        "id": 1,
        "name": "minim"
      },
      {
        "id": 2,
        "name": "non"
      }
    ],
    "cateogries": [
      {
        "id": 1,
        "name": "veniam"
      },
      {
        "id": 2,
        "name": "laborum"
      }
    ],
    "accessWarnings": []
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

In the object the system returns the newly copied item.

Method: move post

Authorization is required.

Request

HTTP request

POST https://<YOUR_DOMAIN>/api/v1/en_US/post/{postId}/move

Parameters

Do not supply a request parameters with this method.

Request body

propertyvaluedescription
postId guid The id of the post you need to copy

Response

propertyvaluedescription
groupId guid The group that you need to move this post to
{
  "timestamp": "2014-03-03T23:20:23Z",
  "success": true,
  "message": "Aliqua anim consequat amet cupidatat proident amet amet.",
  "errors": [],
  "object": {
    "id": "c7fb1cc6-1b67-43e3-969b-ddf4a05442b9",
    "type": "post",
    "group": {
      "id": "83e89cd1-125d-4cee-bd65-6208fe82e341",
      "name": "adipisicing",
      "slug": "Home",
      "thumbUrl": "http://demo.hivesocialnow.com/logo/72_635267855582630000.png",
      "url": "http://demo.hivesocialnow.com/Home/"
    },
    "createdOn": "2014-03-03T23:20:23Z",
    "author": {
      "id": "6b05b94e-e7c6-4bab-9377-e89ae1651425",
      "alias": "labore labore",
      "extendedAlias": "aute commodo eiusmod nisi labore",
      "slug": "Home",
      "avatarUrl": "http://demo.hivesocialnow.com/bigavatar/bc7fbf51-7930-4550-98b0-6a3ff6111ebe.jpg",
      "url": "http://demo.hivesocialnow.com/blog/GeorgiRaykov/site/profile/"
    },
    "approvedOn": "2014-03-03T23:20:23Z",
    "title": "Ex non consectetur eu elit dolor enim.",
    "summary": "Quis consectetur adipisicing cillum sint reprehenderit sint",
    "content": "Reprehenderit aliquip velit cillum nulla ut anim cupidatat minim amet labore non ea.",
    "slug": "1",
    "url": "http://demo.hivesocialnow.com/Home/posts/123",
    "views": 12981,
    "rating": 1,
    "votes": 3,
    "bookmarks": 11,
    "comments": 9,
    "spamReports": 8,
    "isApproved": true,
    "isPromoted": false,
    "canComment": false,
    "isAnonymous": false,
    "typeId": 10,
    "typeName": "Excepteur non commodo nostrud Lorem exercitation ipsum nulla ipsum esse reprehenderit.",
    "statusId": 4,
    "statusName": "Reopened",
    "isDraft": false,
    "tags": [
      {
        "id": 1,
        "name": "minim"
      },
      {
        "id": 2,
        "name": "non"
      }
    ],
    "cateogries": [
      {
        "id": 1,
        "name": "veniam"
      },
      {
        "id": 2,
        "name": "laborum"
      }
    ],
    "accessWarnings": []
  }
}

The general response properties are described on the Response format page. Here are the list of the specific properties for this method.

In the object the system returns the newly moved item.