Get one BlogPost

Retrieve a single BlogPost record by its Id.

GET /api/content/blogposts/{id}

Get one BlogPost

cURL

curl --request GET \
  --url https://spaces.nexudus.com/api/content/blogposts/{id} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/content/blogposts/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/content/blogposts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "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

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

const response = await fetch(
  'https://spaces.nexudus.com/api/content/blogposts/87654321',
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const record = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/content/blogposts/87654321',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

record = response.json()

Response

200

BusinessId · integer

ID of the business linked to this record.

LanguageId · integer

ID of the language linked to this record.

PostedById · integer

ID of the posted by linked to this record.

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

Current file name of the image (read-only; upload via the corresponding URL field).

NewImageUrl · string

URL of a new file to upload as the image.

ClearImageFile · boolean

Set to true to remove the current image file.

LargeImageFileName · string

Current file name of the large image (read-only; upload via the corresponding URL field).

NewLargeImageUrl · string

URL of a new file to upload as the large image.

ClearLargeImageFile · boolean

Set to true to remove the current 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[]

List of blog categories linked to this record.

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": "[e-mail]",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "BlogPost Example",
  "LocalizationDetails": null,
  "CustomFields": null
}