Loading ...

REST API: Update Content Multiple | Axero Documentation

Home » axero documentation » Wiki » Documentation » REST API Overview » REST API: Content » REST API: Update Content Multiple
Axero Documentation  Wiki
Public Space
Activity Stream Content
Version 56

REST API: Update Content Multiple

0 
 /5
0 (0votes)
Open API Guide
PUT/api/content/multiple

You can update existing multiple contents in a single request. For example, set the expiration dates of multiple articles at once. The body is a JSON array of content objects (a single object is also accepted). The response is a bare array with one entry per object, each carrying IsError, a ResponseMessage naming the outcome (with the failing object echoed on an error), and the ContentID as ResponseData; a 200 does not mean every item succeeded.

Request

Request Header

Header Required Value Description
Authorization YES Bearer YOUR_TOKEN Bearer token for the authenticated user. Learn how to create Bearer tokens.
Content-Type YES application/json Must be set to application/json

Required Parameters

Parameter Type Required Location Description
ContentID Integer YES Body Unique ID of the content to update, one per object in the body array. List of supported entities: Articles, Blogs, CMS Pages, Wikis, Ideas, Photos, Albums, Files, Forums, Forum Groups, Forum Topics, Forum Posts. Not validated up front: an object without it matches no content and comes back in the response as its own item with an error status, which is why a request without it answers 200.
Content JSON String YES Body This is JSON that represents a content object that you're updating. This should be of the format seen below in the sample given.

Optional Parameters

Parameter Type Required Location Description
ContentTitle String NO Body Content Title of the entity to be updated
ContentSummary String NO Body Content Summary of Articles, Blogs or Videos to be updated
ContentBody String NO Body Content Body of the entity to be updated
CategoryID Integer NO Body CategoryID for Articles, Blogs, CMSPage or Ideas to be updated
ParentContentID Integer NO Body Used in Wikis, Forums, Forum Topics, Forum Posts to specify the parent content under which this content is updated
ContentStageID Integer NO Body Used in Ideas to specify Idea stage
AuthorID Integer NO Body Author's unique ID. It can be used for ghostwriting purposes, allowing content to be attributed to different authors as needed.
IsFeatured Boolean NO Body Set to true to mark the content as featured, false to clear it.
StatusID Integer NO Body New status, an EntityStatus value: 1 Published, 2 Draft, 5 Expired.
IsContentAvailablePostExpiry Boolean NO Body Set to true to keep the content visible after its expiration date.
DateExpired String NO Body Used to update expiration date of content. Applies to all supported entities except Files.UTC Time format required (24HR): YYYY-MM-DDTHH:MM:SSZ.
DateExpiredISOString String NO Body Used to update the expiration date of File entities only. For all other content types, use DateExpired instead.UTC Time format required (24HR): YYYY-MM-DDTHH:MM:SSZ.

Notes

  • If changing status to 5 (Expired), you must include a DateExpired (or DateExpiredISOString for files) property along with it.
  • If putting DateExpired (or DateExpiredISOString for files) on content in a space where "Content Expiration" is not enabled in settings, the content will still have the new expiration date as a part of the content, but the date will not be visible unless the setting is enabled.

Examples

Example 1

Request Header

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Request URL

https://your-site.com/api/content/multiple

Request Body

[
  {
    "ContentID": 9740,
    "ContentTitle": "Jupiter is the fifth planet from the Sun",
    "ContentBody": "Jupiter is primarily composed of hydrogen with a quarter of its mass being helium, although helium only comprises about a tenth of the number of molecules. It may also have a rocky core of heavier elements, but like the other giant planets, Jupiter lacks a well-defined solid surface."
  },
  {
    "ContentID": 9739,
    "ContentTitle": "Sample article title",
    "ContentBody": "Sample article body."
  },
  {
    "ContentID": 8763,
    "ContentTitle": "Mauris in aliquam sem fringilla ut morbi",
    "ContentBody": "Sample article body."
  },
  {
    "ContentID": 9741,
    "ContentTitle": "Adipiscing commodo elit at imperdiet dui accumsan sit amet nulla",
    "ContentBody": "Sample article body."
  }
]

Success Response

[
  {
    "IsError": false,
    "ResponseMessage": "Expired. Source Object: {\r\n  \"ContentID\": 11277,\r\n  \"ContentTitle\": \"Jupiter is the fifth planet from the Sun f4bb\",\r\n  \"ContentBody\": \"Jupiter is primarily composed of hydrogen with a quarter of its mass being helium, although helium only comprises about a tenth of the number of molecules. It ma...",
    "ResponseData": 11277
  }
]

Example 2

Request Body

[
  {
    "ContentID": 7999,
    "StatusID": 5,
    "IsContentAvailablePostExpiry": true,
    "DateExpired": "2026-12-21T06:30:00Z"
  },
  {
    "ContentID": 7998,
    "StatusID": 5,
    "IsContentAvailablePostExpiry": true,
    "DateExpired": "2026-12-21T06:30:00Z"
  },
  {
    "ContentID": 7995,
    "StatusID": 5,
    "IsContentAvailablePostExpiry": true,
    "DateExpired": "2026-12-21T06:30:00Z"
  },
  {
    "ContentID": 9741,
    "StatusID": 5,
    "IsContentAvailablePostExpiry": false,
    "DateExpired": "2026-12-21T06:30:00Z"
  }
]

Response

[
  {
    "IsError": false,
    "ResponseMessage": "Expired.",
    "ResponseData": 7999
  },
  {
    "IsError": false,
    "ResponseMessage": "Expired.",
    "ResponseData": 7998
  },
  {
    "IsError": false,
    "ResponseMessage": "Expired.",
    "ResponseData": 7995
  },
  {
    "IsError": false,
    "ResponseMessage": "Expired.",
    "ResponseData": 9741
  }
]

Error Response

{
  "IsError": true,
  "ResponseMessage": "Required parameter is missing or invalid.",
  "ResponseData": null
}

Error Handling

Status Code Likely Cause Next Action
400 Bad Request The body is missing (Source Missing). Send a JSON array of content objects.
401 Unauthorized Missing or invalid Bearer token. Check token validity. Learn how to create Bearer tokens →
403 Forbidden User does not have sufficient permissions. Confirm the user has the required roles for this action.
200 with IsError on that item An object's ContentID matches no content, or an item failed to update; its entry in the response array says so. Read every entry in the response array.
500 Server Error Internal failure. Retry later.

Rate Limits

While Axero does not enforce hard rate limits by default, we recommend the following best practices to ensure optimal performance:

  • Sustained Request Rate: Do not exceed 5 API calls per second
  • Sequential Processing: Wait for each request to complete before sending the next in automated workflows
  • Concurrent Connections: If parallel processing is required, limit to 3 or fewer simultaneous requests
  • Response Timeout: Ensure API responses complete within 15 seconds during testing

Axero may implement temporary rate restrictions if excessive API usage affects overall site performance. For high-volume integrations, contact Axero to discuss your requirements.

Wiki Index

Pages