RESTful API
news

Recommendations

Get recommendations

Returns a set of data items of type recommendations.

Copy GET /api/news/recommendations
Request Informaion

URI Parameters

None

Body Parameters

None

Request Formats

None.

Response Informaion

Resource Description

Method can return success code: OK - 200 or one of these error codes: BadRequest - 400, NotFound - 404, NotImplemented - 501, InternalServerError - 500, Unauthorized - 401.

Name Description Type Additional Information
LastModified

System.DateTimeOffset

Read only: True
Selected by default: True

PublicationDate

System.DateTimeOffset

Read only: False
Selected by default: True

DateCreated

System.DateTimeOffset

Read only: True
Selected by default: True

IncludeInSitemap

System.Boolean

Read only: False
Selected by default: True

SystemSourceKey

System.String

Read only: False
Selected by default: True

UrlName

System.String

Read only: False
Selected by default: True

ItemDefaultUrl

System.String

Read only: True
Selected by default: True

regionscountries

System.Guid

Read only: False
Selected by default: False

sustainabledevelopmentgoals

System.Guid

Read only: False
Selected by default: False

Body

System.String

Read only: False
Selected by default: True

targetaudiences

System.Guid

Read only: False
Selected by default: False

IRISID

System.String

Read only: False
Selected by default: True

publishingoffices

System.Guid

Read only: False
Selected by default: False

departmentaltargets

System.Guid

Read only: False
Selected by default: False

Title

System.String

Read only: False
Selected by default: True

healthtopics

System.Guid

Read only: False
Selected by default: False

Provider

System.String

Read only: True
Selected by default: True

Comments

Telerik.Sitefinity.Services.Comments.CommentContract

Read only: True
Selected by default: False

Resource Format

Response Formats
Copy
application/json
[
  {
    "LastModified": "2025-09-12T03:33:03.8824932Z",
    "PublicationDate": "2025-09-12T03:33:03.8824932Z",
    "DateCreated": "2025-09-12T03:33:03.8824932Z",
    "IncludeInSitemap": true,
    "SystemSourceKey": "sample string 5",
    "UrlName": "sample string 6",
    "ItemDefaultUrl": "sample string 7",
    "regionscountries": "ee58d922-14e1-4575-815a-86f9af7e16e5",
    "sustainabledevelopmentgoals": "f37e9aa2-ba80-461a-9cf8-f8ee11b4f697",
    "Body": "sample string 10",
    "targetaudiences": "4d57c3c3-10e9-4a05-8e24-df371882b18f",
    "IRISID": "sample string 12",
    "publishingoffices": "bd7ace0a-ad93-4f4e-b4c0-8c0d5edb09f7",
    "departmentaltargets": "d0f3b7ca-13ca-4b00-a73f-f4e65c746e2d",
    "Title": "sample string 15",
    "healthtopics": "2a9d6086-dee1-4854-849c-fca1015b9cd9",
    "Provider": "sample string 17",
    "Comments": {
      "Name": "sample string 1",
      "Message": "sample string 2",
      "DateCreated": "2025-09-12T03:33:03.8824932+00:00",
      "ProfilePictureUrl": "sample string 4",
      "ProfilePictureThumbnailUrl": "sample string 5"
    }
  },
  {
    "LastModified": "2025-09-12T03:33:03.8824932Z",
    "PublicationDate": "2025-09-12T03:33:03.8824932Z",
    "DateCreated": "2025-09-12T03:33:03.8824932Z",
    "IncludeInSitemap": true,
    "SystemSourceKey": "sample string 5",
    "UrlName": "sample string 6",
    "ItemDefaultUrl": "sample string 7",
    "regionscountries": "ee58d922-14e1-4575-815a-86f9af7e16e5",
    "sustainabledevelopmentgoals": "f37e9aa2-ba80-461a-9cf8-f8ee11b4f697",
    "Body": "sample string 10",
    "targetaudiences": "4d57c3c3-10e9-4a05-8e24-df371882b18f",
    "IRISID": "sample string 12",
    "publishingoffices": "bd7ace0a-ad93-4f4e-b4c0-8c0d5edb09f7",
    "departmentaltargets": "d0f3b7ca-13ca-4b00-a73f-f4e65c746e2d",
    "Title": "sample string 15",
    "healthtopics": "2a9d6086-dee1-4854-849c-fca1015b9cd9",
    "Provider": "sample string 17",
    "Comments": {
      "Name": "sample string 1",
      "Message": "sample string 2",
      "DateCreated": "2025-09-12T03:33:03.8824932+00:00",
      "ProfilePictureUrl": "sample string 4",
      "ProfilePictureThumbnailUrl": "sample string 5"
    }
  }
]

Get recommendations by key

Gets recommendations item by id.

Copy GET /api/news/recommendations({key})
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

Body Parameters

None

Request Formats

None.

Response Informaion

Resource Description

Method can return success code: OK - 200 or one of these error codes: BadRequest - 400, NotFound - 404, NotImplemented - 501, InternalServerError - 500, Unauthorized - 401.

Name Description Type Additional Information
LastModified

System.DateTimeOffset

Read only: True
Selected by default: True

PublicationDate

System.DateTimeOffset

Read only: False
Selected by default: True

DateCreated

System.DateTimeOffset

Read only: True
Selected by default: True

IncludeInSitemap

System.Boolean

Read only: False
Selected by default: True

SystemSourceKey

System.String

Read only: False
Selected by default: True

UrlName

System.String

Read only: False
Selected by default: True

ItemDefaultUrl

System.String

Read only: True
Selected by default: True

regionscountries

System.Guid

Read only: False
Selected by default: False

sustainabledevelopmentgoals

System.Guid

Read only: False
Selected by default: False

Body

System.String

Read only: False
Selected by default: True

targetaudiences

System.Guid

Read only: False
Selected by default: False

IRISID

System.String

Read only: False
Selected by default: True

publishingoffices

System.Guid

Read only: False
Selected by default: False

departmentaltargets

System.Guid

Read only: False
Selected by default: False

Title

System.String

Read only: False
Selected by default: True

healthtopics

System.Guid

Read only: False
Selected by default: False

Provider

System.String

Read only: True
Selected by default: True

Comments

Telerik.Sitefinity.Services.Comments.CommentContract

Read only: True
Selected by default: False

Resource Format

Response Formats
Copy
application/json
{
  "LastModified": "2025-09-12T03:33:03.8824932Z",
  "PublicationDate": "2025-09-12T03:33:03.8824932Z",
  "DateCreated": "2025-09-12T03:33:03.8824932Z",
  "IncludeInSitemap": true,
  "SystemSourceKey": "sample string 5",
  "UrlName": "sample string 6",
  "ItemDefaultUrl": "sample string 7",
  "regionscountries": "ea542637-b7ae-42c7-b295-f98a25bf1c93",
  "sustainabledevelopmentgoals": "224b77bd-3556-4718-9c97-438936e8ee68",
  "Body": "sample string 10",
  "targetaudiences": "3e48e202-2598-49df-9b80-f48116bec023",
  "IRISID": "sample string 12",
  "publishingoffices": "b9c4f085-b5c9-48a8-9637-c6773b5667c7",
  "departmentaltargets": "1141de2b-2ad1-4678-a463-765dbed16e6d",
  "Title": "sample string 15",
  "healthtopics": "89cccb05-4083-42ac-afb6-2d8b3797948c",
  "Provider": "sample string 17",
  "Comments": {
    "Name": "sample string 1",
    "Message": "sample string 2",
    "DateCreated": "2025-09-12T03:33:03.8824932+00:00",
    "ProfilePictureUrl": "sample string 4",
    "ProfilePictureThumbnailUrl": "sample string 5"
  }
}

Get property

Gets Id property from recommendations item.

Copy GET /api/news/recommendations({key})/property
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

property

System.String

Required

Body Parameters

None

Request Formats

None.

Response Informaion

Resource Description

Method can return success code: OK - 200 or one of these error codes: BadRequest - 400, NotFound - 404, NotImplemented - 501, InternalServerError - 500, Unauthorized - 401.

Name Description Type Additional Information
Id

System.Guid

Read only: False

Resource Format

Response Formats
Copy
application/json
{
  "Id": "d0617d42-11ba-4895-8ec3-c7b54c114698"
}

Post recommendations

Creates a recommendations item.

Copy POST /api/news/recommendations
Request Informaion

URI Parameters

None

Body Parameters

Name Description Type Additional Information
LastModified

System.DateTimeOffset

Read only: True
Selected by default: True

PublicationDate

System.DateTimeOffset

Read only: False
Selected by default: True

DateCreated

System.DateTimeOffset

Read only: True
Selected by default: True

IncludeInSitemap

System.Boolean

Read only: False
Selected by default: True

SystemSourceKey

System.String

Read only: False
Selected by default: True

UrlName

System.String

Read only: False
Selected by default: True

ItemDefaultUrl

System.String

Read only: True
Selected by default: True

regionscountries

System.Guid

Read only: False
Selected by default: False

sustainabledevelopmentgoals

System.Guid

Read only: False
Selected by default: False

Body

System.String

Read only: False
Selected by default: True

targetaudiences

System.Guid

Read only: False
Selected by default: False

IRISID

System.String

Read only: False
Selected by default: True

publishingoffices

System.Guid

Read only: False
Selected by default: False

departmentaltargets

System.Guid

Read only: False
Selected by default: False

Title

System.String

Read only: False
Selected by default: True

healthtopics

System.Guid

Read only: False
Selected by default: False

Provider

System.String

Read only: True
Selected by default: True

Comments

Telerik.Sitefinity.Services.Comments.CommentContract

Read only: True
Selected by default: False

Request Formats
Copy
application/json
{
  "PublicationDate": "2025-09-12T03:33:03.8824932Z",
  "IncludeInSitemap": true,
  "SystemSourceKey": "sample string 3",
  "UrlName": "sample string 4",
  "regionscountries": "0d5e0fe6-a983-48b8-9c78-b4d61d6895bc",
  "sustainabledevelopmentgoals": "5f3c1df7-39cc-4e59-9935-3577cf721db0",
  "Body": "sample string 7",
  "targetaudiences": "3e5702f6-2934-469b-95e0-ae329d8cc017",
  "IRISID": "sample string 9",
  "publishingoffices": "f18cb869-10db-49e3-a299-6079105f97b5",
  "departmentaltargets": "df8e876f-2f8a-4a80-a57b-862ce9e7db20",
  "Title": "sample string 12",
  "healthtopics": "a39e5d9e-dd58-4d4c-a610-f5b966bf3447"
}
Response Informaion

Resource Description

Method can return success code: Created - 201 or one of these error codes: BadRequest - 400, NotFound - 404, NotImplemented - 501, InternalServerError - 500, Unauthorized - 401.

Name Description Type Additional Information
LastModified

System.DateTimeOffset

Read only: True
Selected by default: True

PublicationDate

System.DateTimeOffset

Read only: False
Selected by default: True

DateCreated

System.DateTimeOffset

Read only: True
Selected by default: True

IncludeInSitemap

System.Boolean

Read only: False
Selected by default: True

SystemSourceKey

System.String

Read only: False
Selected by default: True

UrlName

System.String

Read only: False
Selected by default: True

ItemDefaultUrl

System.String

Read only: True
Selected by default: True

regionscountries

System.Guid

Read only: False
Selected by default: False

sustainabledevelopmentgoals

System.Guid

Read only: False
Selected by default: False

Body

System.String

Read only: False
Selected by default: True

targetaudiences

System.Guid

Read only: False
Selected by default: False

IRISID

System.String

Read only: False
Selected by default: True

publishingoffices

System.Guid

Read only: False
Selected by default: False

departmentaltargets

System.Guid

Read only: False
Selected by default: False

Title

System.String

Read only: False
Selected by default: True

healthtopics

System.Guid

Read only: False
Selected by default: False

Provider

System.String

Read only: True
Selected by default: True

Comments

Telerik.Sitefinity.Services.Comments.CommentContract

Read only: True
Selected by default: False

Resource Format

Response Formats
Copy
application/json
{
  "LastModified": "2025-09-12T03:33:03.8824932Z",
  "PublicationDate": "2025-09-12T03:33:03.8824932Z",
  "DateCreated": "2025-09-12T03:33:03.8824932Z",
  "IncludeInSitemap": true,
  "SystemSourceKey": "sample string 5",
  "UrlName": "sample string 6",
  "ItemDefaultUrl": "sample string 7",
  "regionscountries": "1a8904bb-7523-4330-a8c9-fb4906cc0688",
  "sustainabledevelopmentgoals": "7a40dad9-d285-4d9f-b5c2-f49a3694ab6e",
  "Body": "sample string 10",
  "targetaudiences": "ce7eee76-e459-46bd-868e-987709e098ac",
  "IRISID": "sample string 12",
  "publishingoffices": "31c58064-d7db-48ed-b224-5e552beecd0b",
  "departmentaltargets": "1de3139f-ccbf-48c3-addb-905eac1e068a",
  "Title": "sample string 15",
  "healthtopics": "e78ff8f5-12e7-43a3-aad3-b906059de8cc",
  "Provider": "sample string 17",
  "Comments": {
    "Name": "sample string 1",
    "Message": "sample string 2",
    "DateCreated": "2025-09-12T03:33:03.8824932+00:00",
    "ProfilePictureUrl": "sample string 4",
    "ProfilePictureThumbnailUrl": "sample string 5"
  }
}

Patch recommendations by key

Partial update for recommendations item.

Copy PATCH /api/news/recommendations({key})
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

Body Parameters

Name Description Type Additional Information
LastModified

System.DateTimeOffset

Read only: True
Selected by default: True

PublicationDate

System.DateTimeOffset

Read only: False
Selected by default: True

DateCreated

System.DateTimeOffset

Read only: True
Selected by default: True

IncludeInSitemap

System.Boolean

Read only: False
Selected by default: True

SystemSourceKey

System.String

Read only: False
Selected by default: True

UrlName

System.String

Read only: False
Selected by default: True

ItemDefaultUrl

System.String

Read only: True
Selected by default: True

regionscountries

System.Guid

Read only: False
Selected by default: False

sustainabledevelopmentgoals

System.Guid

Read only: False
Selected by default: False

Body

System.String

Read only: False
Selected by default: True

targetaudiences

System.Guid

Read only: False
Selected by default: False

IRISID

System.String

Read only: False
Selected by default: True

publishingoffices

System.Guid

Read only: False
Selected by default: False

departmentaltargets

System.Guid

Read only: False
Selected by default: False

Title

System.String

Read only: False
Selected by default: True

healthtopics

System.Guid

Read only: False
Selected by default: False

Provider

System.String

Read only: True
Selected by default: True

Comments

Telerik.Sitefinity.Services.Comments.CommentContract

Read only: True
Selected by default: False

Request Formats
Copy
application/json
{
  "PublicationDate": "2025-09-12T03:33:03.8824932Z",
  "IncludeInSitemap": true,
  "SystemSourceKey": "sample string 3",
  "UrlName": "sample string 4",
  "regionscountries": "bf0880cc-4810-45ae-9bf2-c65a78dbeb2c",
  "sustainabledevelopmentgoals": "642f1056-5aeb-44be-a44d-581011ac6a13",
  "Body": "sample string 7",
  "targetaudiences": "bc819702-b812-4bc1-9915-55b4c29de7d9",
  "IRISID": "sample string 9",
  "publishingoffices": "8df1da2d-1e22-4141-9c08-9b00735d7f10",
  "departmentaltargets": "1a29933e-2aa5-4aeb-9504-40518cd8972f",
  "Title": "sample string 12",
  "healthtopics": "1c38f541-52df-4fe8-92b1-5ae1de656b7f"
}
Response Informaion

Resource Description

Method can return success code: NoContent - 204 or one of these error codes: BadRequest - 400, NotFound - 404, NotImplemented - 501, InternalServerError - 500, Unauthorized - 401.

Resource Format

Response Formats

None.

Put recommendations by key

Full update for recommendations item.

Copy PUT /api/news/recommendations({key})
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

Body Parameters

Name Description Type Additional Information
LastModified

System.DateTimeOffset

Read only: True
Selected by default: True

PublicationDate

System.DateTimeOffset

Read only: False
Selected by default: True

DateCreated

System.DateTimeOffset

Read only: True
Selected by default: True

IncludeInSitemap

System.Boolean

Read only: False
Selected by default: True

SystemSourceKey

System.String

Read only: False
Selected by default: True

UrlName

System.String

Read only: False
Selected by default: True

ItemDefaultUrl

System.String

Read only: True
Selected by default: True

regionscountries

System.Guid

Read only: False
Selected by default: False

sustainabledevelopmentgoals

System.Guid

Read only: False
Selected by default: False

Body

System.String

Read only: False
Selected by default: True

targetaudiences

System.Guid

Read only: False
Selected by default: False

IRISID

System.String

Read only: False
Selected by default: True

publishingoffices

System.Guid

Read only: False
Selected by default: False

departmentaltargets

System.Guid

Read only: False
Selected by default: False

Title

System.String

Read only: False
Selected by default: True

healthtopics

System.Guid

Read only: False
Selected by default: False

Provider

System.String

Read only: True
Selected by default: True

Comments

Telerik.Sitefinity.Services.Comments.CommentContract

Read only: True
Selected by default: False

Request Formats
Copy
application/json
{
  "PublicationDate": "2025-09-12T03:33:03.8824932Z",
  "IncludeInSitemap": true,
  "SystemSourceKey": "sample string 3",
  "UrlName": "sample string 4",
  "regionscountries": "bf889160-adaf-4346-bfd2-ad68be24624e",
  "sustainabledevelopmentgoals": "cf742c6d-b270-4e40-8ecd-0ec1f11d4954",
  "Body": "sample string 7",
  "targetaudiences": "517c2cc0-719f-43af-b6ff-8dc225d62b34",
  "IRISID": "sample string 9",
  "publishingoffices": "e93fbaec-0e15-442a-a1dc-9ca397e38a4f",
  "departmentaltargets": "c081e937-dd0d-418a-92f4-fa58ce84cce9",
  "Title": "sample string 12",
  "healthtopics": "c064c381-b08c-4ac3-8342-33927f58a69b"
}
Response Informaion

Resource Description

Method can return success code: NoContent - 204 or one of these error codes: BadRequest - 400, NotFound - 404, NotImplemented - 501, InternalServerError - 500, Unauthorized - 401.

Resource Format

Response Formats

None.

Delete recommendations by key

Deletes a recommendations item by Id.

Copy DELETE /api/news/recommendations({key})
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

Body Parameters

None

Request Formats

None.

Response Informaion

Resource Description

Method can return success code: NoContent - 204 or one of these error codes: BadRequest - 400, NotFound - 404, NotImplemented - 501, InternalServerError - 500, Unauthorized - 401.

Resource Format

Response Formats

None.