Skip to main content
GET
/
api
/
content
/
blogposts
/
{id}
{
  "BusinessId": 123,
  "LanguageId": 123,
  "PostedById": 123,
  "PostedByFullName": "<string>",
  "Title": "<string>",
  "SummaryText": "<string>",
  "FullText": "<string>",
  "ImageFileName": "<string>",
  "NewImageUrl": "<string>",
  "ClearImageFile": true,
  "LargeImageFileName": "<string>",
  "NewLargeImageUrl": "<string>",
  "ClearLargeImageFile": true,
  "PublishDate": "<string>",
  "ShowInHomeBanner": true,
  "ShowInHomePage": true,
  "UnpublishDate": "<string>",
  "AllowComments": true,
  "BlogCategories": [
    123
  ],
  "CommentsCount": 123,
  "OnlyForContacts": true,
  "OnlyForMembers": true,
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}
A BlogPost represents an article published on the Members Portal. Articles can be used to share news, updates, or useful content with customers. Articles support scheduled publishing via PublishDate and automatic unpublishing via UnpublishDate. Setting a PublishDate in the past publishes the article immediately; setting a future date schedules it. Leaving UnpublishDate blank keeps the article published until it is manually unpublished or deleted. Each article has a SummaryText (short overview displayed at the top) and a FullText (the main body content). Articles can be organised into categories using the BlogCategory entity and can optionally allow customer comments. Visibility can be controlled with OnlyForMembers (customers with an active contract) and OnlyForContacts (customers without an active contract). Articles can also be featured on the Members Portal home page before login (ShowInHomeBanner) or after login (ShowInHomePage).

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the BlogPost-Read role.

Path Parameters

id
integer
required
The Id of the BlogPost record to retrieve.

Code Examples

curl -X GET \
  "https://spaces.nexudus.com/api/content/blogposts/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

BusinessId
integer
Business Id.
LanguageId
integer
Language Id.
PostedById
integer
Posted By Id.
PostedByFullName
string
Full name of the article author.
Title
string
Article title.
SummaryText
string
Short overview displayed at the top of the article.
FullText
string
Main body content of the article.
ImageFileName
string
Image File Name.
NewImageUrl
string
New Image Url.
ClearImageFile
boolean
Clear Image File.
LargeImageFileName
string
Large Image File Name.
NewLargeImageUrl
string
New Large Image Url.
ClearLargeImageFile
boolean
Clear Large Image File.
PublishDate
string
Date and time when the article is published. Past dates publish immediately; future dates schedule publication.
ShowInHomeBanner
boolean
Feature this article on the Members Portal home page before users log in.
ShowInHomePage
boolean
Feature this article on the Members Portal home page after users log in.
UnpublishDate
string
Date and time when the article is automatically unpublished. Leave blank to keep published indefinitely.
AllowComments
boolean
Whether customers can post comments on this article.
BlogCategories
integer[]
Blog Categories.
CommentsCount
integer
Number of comments on this article.
OnlyForContacts
boolean
Restrict visibility to contacts (customers without an active contract).
OnlyForMembers
boolean
Restrict visibility to members (customers with an active contract).
Id
integer
Unique record identifier.
UniqueId
string
UUID of the record.
CreatedOn
string
Date and time the record was created (ISO 8601).
UpdatedOn
string
Date and time the record was last updated (ISO 8601).
UpdatedBy
string
Email of the user who last updated this record.
IsNew
boolean
Whether the record was recently created.
SystemId
string
External system identifier.
Example Response
{
  "BusinessId": 0,
  "LanguageId": null,
  "PostedById": null,
  "PostedByFullName": null,
  "Title": "",
  "SummaryText": null,
  "FullText": null,
  "ImageFileName": null,
  "NewImageUrl": null,
  "ClearImageFile": null,
  "LargeImageFileName": null,
  "NewLargeImageUrl": null,
  "ClearLargeImageFile": null,
  "PublishDate": null,
  "ShowInHomeBanner": false,
  "ShowInHomePage": false,
  "UnpublishDate": null,
  "AllowComments": false,
  "BlogCategories": [],
  "CommentsCount": 0,
  "OnlyForContacts": false,
  "OnlyForMembers": false,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "BlogPost Example",
  "LocalizationDetails": null,
  "CustomFields": null
}