Skip to main content
POST
/
posts
/
{id}
Update a post by id
curl --request POST \
  --url https://{subdomain}.nudj.cx/api/v2/admin/posts/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "content": "<string>",
  "disableComments": true,
  "disableLikes": true,
  "displayBannerOnPost": true,
  "status": "archived",
  "startsAt": "<string>",
  "expiresAt": "<string>",
  "tags": [
    "<string>"
  ],
  "campaigns": [
    "<string>"
  ],
  "featured": true,
  "isGlobalTemplate": true,
  "availableAsTemplateForOrganisations": [
    "<string>"
  ],
  "details": {
    "title": "<string>",
    "description": "<string>",
    "light": {
      "primaryImageUrl": "<string>",
      "secondaryImageUrl": "<string>"
    },
    "dark": {
      "primaryImageUrl": "<string>",
      "secondaryImageUrl": "<string>"
    }
  }
}
'
{
  "id": "<string>",
  "organisationId": "<string>",
  "communityId": "<string>",
  "details": {
    "title": "<string>",
    "description": "<string>",
    "light": {
      "primaryImageUrl": "<string>",
      "secondaryImageUrl": "<string>"
    },
    "dark": {
      "primaryImageUrl": "<string>",
      "secondaryImageUrl": "<string>"
    }
  },
  "likes": [
    "<string>"
  ],
  "disableComments": true,
  "disableLikes": true,
  "displayBannerOnPost": true,
  "status": "archived",
  "tags": [
    "<string>"
  ],
  "campaigns": [
    "<string>"
  ],
  "availableAsTemplateForOrganisations": [
    "<string>"
  ],
  "isGlobalTemplate": true,
  "createdAt": "<string>",
  "createdBy": "<string>",
  "isEditing": true,
  "content": "<string>",
  "startsAt": "<string>",
  "expiresAt": "<string>",
  "featured": true,
  "updatedAt": "<string>",
  "updatedBy": "<string>"
}

Authorizations

​
x-api-token
string
header
required

Headers

​
x-language
string

The language to update the post in. This will update the post's content for the specified language.

Path Parameters

​
id
string
required

The id of the post to update

Body

application/json

The input required to update a post

​
content
string | null

The content of the post in HTML. Example:

Welcome to Your New Post

This is a placeholder post to demonstrate the capabilities of the editor. Feel free to explore and edit this content to see what you can do!

Basic Formatting

You can use bold, italic, underline, and strikethrough text to emphasize your content.

Lists

You can create a bullet list:

  • Item 1

  • Item 2

  • Item 3

Or a numberered list:

  1. First Item

  2. Second Item

  3. Third Item

Links

You can also add links to your content. For example, visit Example.com for more information.

Images

Including images is simple. Here is an example image:

Blockquotes

You can use blockquotes to highlight important quotes or information:

"This is a sample blockquote. It's great for highlighting quotes or important information in your post."

Feel free to edit this content and explore the various features of the editor. Happy posting!

​
disableComments
boolean

Whether comments are disabled on this post. Defaults to false.

​
disableLikes
boolean

Whether likes are disabled on this post. Defaults to false.

​
displayBannerOnPost
boolean

Whether to display a banner on this post. Defaults to false.

​
status
enum<string>

The status of the post

Available options:
archived,
draft,
expired,
live,
scheduled
​
startsAt
string | null

The date when this post becomes visible.

​
expiresAt
string | null

The date when this post expires.

​
tags
string[]

A list of tags to associate with this post

​
campaigns
string[]

A list of campaigns to associate with this post

​
featured
boolean | null
​
isGlobalTemplate
boolean

Whether the post is a global template

​
availableAsTemplateForOrganisations
string[]

The organisations that the post is available as a template for

​
details
Details Update Input · object

Input for updating entity details with all fields optional

Response

Successful response

A post

​
id
string
required

The id of the post

​
organisationId
string
required

The organisation that the post belongs to

​
communityId
string
required

The community that the post belongs to

​
details
Details · object
required

The details of this post such as title, description, bannerUrl, logoUrl

​
likes
string[]
required

Array of user IDs who liked this post

​
disableComments
boolean
required

Whether comments are disabled on this post. Defaults to false.

​
disableLikes
boolean
required

Whether likes are disabled on this post. Defaults to false.

​
displayBannerOnPost
boolean
required

Whether to display a banner on this post. Defaults to false.

​
status
enum<string>
required

The status of the post

Available options:
archived,
draft,
expired,
live,
scheduled
​
tags
string[]
required

A list of tags to associate with this post

​
campaigns
string[]
required

A list of campaigns to associate with this post

​
availableAsTemplateForOrganisations
string[]
required

The organisations that the post is available as a template for

​
isGlobalTemplate
boolean
required

Whether the post is a global template

​
createdAt
string
required

The date when this post was created

​
createdBy
string
required

The user who created this post

​
isEditing
boolean
required
​
content
string | null

The content of the post in HTML. Example:

Welcome to Your New Post

This is a placeholder post to demonstrate the capabilities of the editor. Feel free to explore and edit this content to see what you can do!

Basic Formatting

You can use bold, italic, underline, and strikethrough text to emphasize your content.

Lists

You can create a bullet list:

  • Item 1

  • Item 2

  • Item 3

Or a numberered list:

  1. First Item

  2. Second Item

  3. Third Item

Links

You can also add links to your content. For example, visit Example.com for more information.

Images

Including images is simple. Here is an example image:

Blockquotes

You can use blockquotes to highlight important quotes or information:

"This is a sample blockquote. It's great for highlighting quotes or important information in your post."

Feel free to edit this content and explore the various features of the editor. Happy posting!

​
startsAt
string | null

The date when this post becomes visible.

​
expiresAt
string | null

The date when this post expires.

​
featured
boolean | null
​
updatedAt
string | null

The date when this post was updated

​
updatedBy
string | null

The user who last updated this post