RESTful API

Documents

Get documents

Returns a set of data items of type documents.

Copy GET /api/news/documents
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

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

Ordinal

System.Single

Read only: False

UrlName

System.String

Read only: False

Author

System.String

Read only: False

Extension

System.String

Read only: True

MimeType

System.String

Read only: True

TotalSize

System.Int64

Read only: True

Tags

System.Guid

Read only: False

Category

System.Guid

Read only: False

Parts

System.String

Read only: False

FolderId

System.Guid

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

Url

System.String

Read only: True

ThumbnailUrl

System.String

Read only: True

Thumbnails

Telerik.Sitefinity.Modules.Libraries.Web.Services.Extensibility.ThumbnailModel

Read only: True

Resource Format

Response Formats
Copy
application/json
[
  {
    "LastModified": "2024-12-20T18:57:05.5456891Z",
    "PublicationDate": "2024-12-20T18:57:05.5456891Z",
    "Title": "sample string 3",
    "Description": "sample string 4",
    "DateCreated": "2024-12-20T18:57:05.5456891Z",
    "IncludeInSitemap": true,
    "Ordinal": 7.1,
    "UrlName": "sample string 8",
    "Author": "sample string 9",
    "Extension": "sample string 10",
    "MimeType": "sample string 11",
    "TotalSize": 12,
    "Tags": "6ea3e588-e3d2-4a7a-ad5e-81abae7b6714",
    "Category": "c8f44135-24c5-4eb7-bfe3-cc9ffa7a0a74",
    "Parts": "sample string 15",
    "FolderId": "5e2be10e-64b6-4070-9d2b-f894282dd678",
    "ParentId": "a8c17aa5-a2ea-441d-8897-9f07575c3cc8",
    "Provider": "sample string 18",
    "Url": "sample string 19",
    "ThumbnailUrl": "sample string 20",
    "Thumbnails": {
      "Title": "sample string 1",
      "Url": "sample string 2",
      "Width": 3
    }
  },
  {
    "LastModified": "2024-12-20T18:57:05.5456891Z",
    "PublicationDate": "2024-12-20T18:57:05.5456891Z",
    "Title": "sample string 3",
    "Description": "sample string 4",
    "DateCreated": "2024-12-20T18:57:05.5456891Z",
    "IncludeInSitemap": true,
    "Ordinal": 7.1,
    "UrlName": "sample string 8",
    "Author": "sample string 9",
    "Extension": "sample string 10",
    "MimeType": "sample string 11",
    "TotalSize": 12,
    "Tags": "6ea3e588-e3d2-4a7a-ad5e-81abae7b6714",
    "Category": "c8f44135-24c5-4eb7-bfe3-cc9ffa7a0a74",
    "Parts": "sample string 15",
    "FolderId": "5e2be10e-64b6-4070-9d2b-f894282dd678",
    "ParentId": "a8c17aa5-a2ea-441d-8897-9f07575c3cc8",
    "Provider": "sample string 18",
    "Url": "sample string 19",
    "ThumbnailUrl": "sample string 20",
    "Thumbnails": {
      "Title": "sample string 1",
      "Url": "sample string 2",
      "Width": 3
    }
  }
]

Get documents by key

Gets documents item by id.

Copy GET /api/news/documents({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

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

Ordinal

System.Single

Read only: False

UrlName

System.String

Read only: False

Author

System.String

Read only: False

Extension

System.String

Read only: True

MimeType

System.String

Read only: True

TotalSize

System.Int64

Read only: True

Tags

System.Guid

Read only: False

Category

System.Guid

Read only: False

Parts

System.String

Read only: False

FolderId

System.Guid

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

Url

System.String

Read only: True

ThumbnailUrl

System.String

Read only: True

Thumbnails

Telerik.Sitefinity.Modules.Libraries.Web.Services.Extensibility.ThumbnailModel

Read only: True

Resource Format

Response Formats
Copy
application/json
{
  "LastModified": "2024-12-20T18:57:05.5456891Z",
  "PublicationDate": "2024-12-20T18:57:05.5456891Z",
  "Title": "sample string 3",
  "Description": "sample string 4",
  "DateCreated": "2024-12-20T18:57:05.5456891Z",
  "IncludeInSitemap": true,
  "Ordinal": 7.1,
  "UrlName": "sample string 8",
  "Author": "sample string 9",
  "Extension": "sample string 10",
  "MimeType": "sample string 11",
  "TotalSize": 12,
  "Tags": "c82464a4-d131-4fcc-9a3a-4296d4a5f2c5",
  "Category": "6758917f-baec-469d-a62c-ff49f8829b29",
  "Parts": "sample string 15",
  "FolderId": "adf762fb-666b-414e-9434-0dc1844cdfd5",
  "ParentId": "d4b2a412-a03e-4717-9d71-3d3b67dd9af8",
  "Provider": "sample string 18",
  "Url": "sample string 19",
  "ThumbnailUrl": "sample string 20",
  "Thumbnails": {
    "Title": "sample string 1",
    "Url": "sample string 2",
    "Width": 3
  }
}

Get property

Gets Id property from documents item.

Copy GET /api/news/documents({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": "6544ad26-4c61-4034-a69e-be1beb4f2007"
}

Post documents

Creates a documents item.

Copy POST /api/news/documents
Request Informaion

URI Parameters

None

Body Parameters

Name Description Type Additional Information
LastModified

System.DateTimeOffset

Read only: True

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

Ordinal

System.Single

Read only: False

UrlName

System.String

Read only: False

Author

System.String

Read only: False

Extension

System.String

Read only: True

MimeType

System.String

Read only: True

TotalSize

System.Int64

Read only: True

Tags

System.Guid

Read only: False

Category

System.Guid

Read only: False

Parts

System.String

Read only: False

FolderId

System.Guid

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

Url

System.String

Read only: True

ThumbnailUrl

System.String

Read only: True

Thumbnails

Telerik.Sitefinity.Modules.Libraries.Web.Services.Extensibility.ThumbnailModel

Read only: True

Request Formats
Copy
application/json
{
  "PublicationDate": "2024-12-20T18:57:05.5456891Z",
  "Title": "sample string 2",
  "Description": "sample string 3",
  "IncludeInSitemap": true,
  "Ordinal": 5.1,
  "UrlName": "sample string 6",
  "Author": "sample string 7",
  "Tags": "411a6803-fb94-48dd-ac87-d16f0b275138",
  "Category": "f9952ef3-8c77-45ec-a685-7a6725d6e76e",
  "Parts": "sample string 10",
  "FolderId": "dec4d4da-41bf-42ba-93ee-d6fb2c77bd63",
  "ParentId": "d44b52d8-ac7b-47f0-b319-e3cb98009989"
}
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

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

Ordinal

System.Single

Read only: False

UrlName

System.String

Read only: False

Author

System.String

Read only: False

Extension

System.String

Read only: True

MimeType

System.String

Read only: True

TotalSize

System.Int64

Read only: True

Tags

System.Guid

Read only: False

Category

System.Guid

Read only: False

Parts

System.String

Read only: False

FolderId

System.Guid

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

Url

System.String

Read only: True

ThumbnailUrl

System.String

Read only: True

Thumbnails

Telerik.Sitefinity.Modules.Libraries.Web.Services.Extensibility.ThumbnailModel

Read only: True

Resource Format

Response Formats
Copy
application/json
{
  "LastModified": "2024-12-20T18:57:05.5456891Z",
  "PublicationDate": "2024-12-20T18:57:05.5456891Z",
  "Title": "sample string 3",
  "Description": "sample string 4",
  "DateCreated": "2024-12-20T18:57:05.5456891Z",
  "IncludeInSitemap": true,
  "Ordinal": 7.1,
  "UrlName": "sample string 8",
  "Author": "sample string 9",
  "Extension": "sample string 10",
  "MimeType": "sample string 11",
  "TotalSize": 12,
  "Tags": "8fc16dff-bdf5-4ba0-938d-c2012a060dfc",
  "Category": "fa982db4-5950-41d0-9432-750703de7d40",
  "Parts": "sample string 15",
  "FolderId": "0111c6b1-6d01-46c3-9578-ae849791ed3b",
  "ParentId": "7fd2511e-4c5c-421c-aa64-2d52432e85a1",
  "Provider": "sample string 18",
  "Url": "sample string 19",
  "ThumbnailUrl": "sample string 20",
  "Thumbnails": {
    "Title": "sample string 1",
    "Url": "sample string 2",
    "Width": 3
  }
}

Patch documents by key

Partial update for documents item.

Copy PATCH /api/news/documents({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

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

Ordinal

System.Single

Read only: False

UrlName

System.String

Read only: False

Author

System.String

Read only: False

Extension

System.String

Read only: True

MimeType

System.String

Read only: True

TotalSize

System.Int64

Read only: True

Tags

System.Guid

Read only: False

Category

System.Guid

Read only: False

Parts

System.String

Read only: False

FolderId

System.Guid

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

Url

System.String

Read only: True

ThumbnailUrl

System.String

Read only: True

Thumbnails

Telerik.Sitefinity.Modules.Libraries.Web.Services.Extensibility.ThumbnailModel

Read only: True

Request Formats
Copy
application/json
{
  "PublicationDate": "2024-12-20T18:57:05.5456891Z",
  "Title": "sample string 2",
  "Description": "sample string 3",
  "IncludeInSitemap": true,
  "Ordinal": 5.1,
  "UrlName": "sample string 6",
  "Author": "sample string 7",
  "Tags": "ad4bb89f-f2ee-4e34-abd5-b1fe12595a99",
  "Category": "b9536b2c-2e62-4bb1-8e7c-cefee15abb75",
  "Parts": "sample string 10",
  "FolderId": "d76c1dce-de4f-408b-bb92-e7cf55b8d943",
  "ParentId": "f7ff7f3e-c679-425e-ab58-e486a9b84e8d"
}
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 documents by key

Full update for documents item.

Copy PUT /api/news/documents({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

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

Ordinal

System.Single

Read only: False

UrlName

System.String

Read only: False

Author

System.String

Read only: False

Extension

System.String

Read only: True

MimeType

System.String

Read only: True

TotalSize

System.Int64

Read only: True

Tags

System.Guid

Read only: False

Category

System.Guid

Read only: False

Parts

System.String

Read only: False

FolderId

System.Guid

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

Url

System.String

Read only: True

ThumbnailUrl

System.String

Read only: True

Thumbnails

Telerik.Sitefinity.Modules.Libraries.Web.Services.Extensibility.ThumbnailModel

Read only: True

Request Formats
Copy
application/json
{
  "PublicationDate": "2024-12-20T18:57:05.5456891Z",
  "Title": "sample string 2",
  "Description": "sample string 3",
  "IncludeInSitemap": true,
  "Ordinal": 5.1,
  "UrlName": "sample string 6",
  "Author": "sample string 7",
  "Tags": "a52a8365-ac16-4b12-b957-c85959705c69",
  "Category": "d9615043-68b0-4166-b7bf-a95e8775a29f",
  "Parts": "sample string 10",
  "FolderId": "e8af360b-72d9-4a88-8f3e-9b61d8477f86",
  "ParentId": "113ef395-d2dc-405c-adb1-ed2c87dfe269"
}
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 documents by key

Deletes a documents item by Id.

Copy DELETE /api/news/documents({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.

Get Parent

Returns a set of related items of type Parent from documents item.

Copy GET /api/news/documents({key})/Parent
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

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

UrlName

System.String

Read only: False

MaxSize

System.Int64

Read only: False

MaxItemSize

System.Int64

Read only: False

BlobStorageProvider

System.String

Read only: False

OutputCacheProfile

System.String

Read only: False

ClientCacheProfile

System.String

Read only: False

CoverId

System.Guid

Read only: False

ThumbnailProfiles

System.String

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

ChildrenCount

System.Int32

Read only: True

Resource Format

Response Formats
Copy
application/json
[
  {
    "LastModified": "2024-12-20T18:57:05.5456891Z",
    "PublicationDate": "2024-12-20T18:57:05.5456891Z",
    "Title": "sample string 3",
    "Description": "sample string 4",
    "DateCreated": "2024-12-20T18:57:05.5456891Z",
    "IncludeInSitemap": true,
    "UrlName": "sample string 7",
    "MaxSize": 8,
    "MaxItemSize": 9,
    "BlobStorageProvider": "sample string 10",
    "OutputCacheProfile": "sample string 11",
    "ClientCacheProfile": "sample string 12",
    "CoverId": "385c576d-918e-4a99-bab4-5415229c4bea",
    "ThumbnailProfiles": "sample string 14",
    "ParentId": "23754c8c-3346-437e-9392-ffe69aaded76",
    "Provider": "sample string 16",
    "ChildrenCount": 17
  },
  {
    "LastModified": "2024-12-20T18:57:05.5456891Z",
    "PublicationDate": "2024-12-20T18:57:05.5456891Z",
    "Title": "sample string 3",
    "Description": "sample string 4",
    "DateCreated": "2024-12-20T18:57:05.5456891Z",
    "IncludeInSitemap": true,
    "UrlName": "sample string 7",
    "MaxSize": 8,
    "MaxItemSize": 9,
    "BlobStorageProvider": "sample string 10",
    "OutputCacheProfile": "sample string 11",
    "ClientCacheProfile": "sample string 12",
    "CoverId": "385c576d-918e-4a99-bab4-5415229c4bea",
    "ThumbnailProfiles": "sample string 14",
    "ParentId": "23754c8c-3346-437e-9392-ffe69aaded76",
    "Provider": "sample string 16",
    "ChildrenCount": 17
  }
]

Get Parent by relatedKey

Returns a related item of type Parent from documents item.

Copy GET /api/news/documents({key})/Parent({relatedKey})
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

relatedKey

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

PublicationDate

System.DateTimeOffset

Read only: False

Title

System.String

Read only: False

Description

System.String

Read only: False

DateCreated

System.DateTimeOffset

Read only: True

IncludeInSitemap

System.Boolean

Read only: False

UrlName

System.String

Read only: False

MaxSize

System.Int64

Read only: False

MaxItemSize

System.Int64

Read only: False

BlobStorageProvider

System.String

Read only: False

OutputCacheProfile

System.String

Read only: False

ClientCacheProfile

System.String

Read only: False

CoverId

System.Guid

Read only: False

ThumbnailProfiles

System.String

Read only: False

ParentId

System.Guid

Read only: False

Provider

System.String

Read only: True

ChildrenCount

System.Int32

Read only: True

Resource Format

Response Formats
Copy
application/json
{
  "LastModified": "2024-12-20T18:57:05.5456891Z",
  "PublicationDate": "2024-12-20T18:57:05.5456891Z",
  "Title": "sample string 3",
  "Description": "sample string 4",
  "DateCreated": "2024-12-20T18:57:05.5456891Z",
  "IncludeInSitemap": true,
  "UrlName": "sample string 7",
  "MaxSize": 8,
  "MaxItemSize": 9,
  "BlobStorageProvider": "sample string 10",
  "OutputCacheProfile": "sample string 11",
  "ClientCacheProfile": "sample string 12",
  "CoverId": "8f191d9c-44a0-41c2-8955-67ba3c10da98",
  "ThumbnailProfiles": "sample string 14",
  "ParentId": "aa1c9756-c5c4-49ff-9568-6a11164f9d00",
  "Provider": "sample string 16",
  "ChildrenCount": 17
}

Post Parent

Add Parent relation to documents item.

Copy POST /api/news/documents({key})/Parent/$ref
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

Body Parameters

None

Request Formats
Copy
application/json
{
  "@odata.id": "http://host/route/service/type(key)"
}
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 Parent

Delete set of related items of type Parent from documents item.

Copy DELETE /api/news/documents({key})/Parent/$ref
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.

Delete Parent by relatedKey

Delete relation of type Parent from documents item.

Copy DELETE /api/news/documents({key})/Parent({relatedKey})/$ref
Request Informaion

URI Parameters

Name Description Type Additional Information
key

System.Guid

Required

relatedKey

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.