Discussions

We are experiencing an issue when attempting to use the PUT method to update ContentItem objects via the iMIS REST API on our instance (imis.fascrs.org). We consistently receive a 501 Not Implemented error.

According to the API documentation, the PUT method should allow us to update existing ContentItem instances using the ContentItemKey. However, our attempts have been unsuccessful.

Here are the details of our requests:

1. Example GET Request (Successful):

We successfully retrieve ContentItem data using the following GET request:

GET https://{my-imis-instance}/api/ContentItem?ContentKey=3ee09860-df89-4038-98ea-b3001e9ce8b2&ContentItemKey=6bc5e0fa-2166-48e8-900c-aa8b30af033d

This returns the following JSON response:

{
  "$type": "Asi.Soa.Core.DataContracts.PagedResult`1[[Asi.Soa.Core.DataContracts.ContentItemData, Asi.Contracts]], Asi.Contracts",

  "Items": {
    "$type": "System.Collections.Generic.List`1[[Asi.Soa.Core.DataContracts.ContentItemData, Asi.Contracts]], mscorlib",

    "$values": [
      {
        "$type": "Asi.Soa.Core.DataContracts.ContentItemData, Asi.Contracts",

        "Data": {
          "$type": "Asi.Business.ContentManagement.ContentBigButtonPanel, Asi.Shared",
          "ContentKey": "3ee09860-df89-4038-98ea-b3001e9ce8b2",
          "ContentTypeKey": "47e1a269-dc81-44d9-b1c0-e26f91c4a2f8",
          "ContentItemKey": "6bc5e0fa-2166-48e8-900c-aa8b30af033d",
          "ShowTitleFlag": false,
          "SortOrder": 1,
          "LayoutZone": 1,
          "ContentItemName": "New ContentBigButtonPanel",
          "IconUrl": null,
          "PageTitle": null,
          "ImageUrl": null,
          "NavigationIdentifier": null,
          "ChildLevelsToDisplay": 0,
          "Links": {
            "$type": "System.Collections.ObjectModel.Collection`1[[Asi.StringPair, Asi]], mscorlib",
            "$values": [
              {
                "$type": "Asi.StringPair, Asi",
                "First": "@/PortalTest/About/About",
                "Second": "Event Search"
              }
            ]
          },
          "ExistingLegacyBorder": "ExistingLegacyBorder",
          "ActionMode": "Navigation",
          "UsePopup": false,
          "AltText": null,
          "IncludeParentLevelItem": false,
          "DisplayForAuthorizedUsersOnly": false,
          "DisplayAs": "Links",
          "DropdownText": "Actions",
          "PartTitle": null,
          "PartDescription": null,
          "PartTitleHeadingLevel": 2,
          "DoNotRenderInDesignMode": false,
          "CssClass": null,
          "ShowBorder": false,
          "Collapsible": false,
          "Collapsed": false,
          "DisplayOnExtraSmallScreens": true,
          "DisplayOnSmallScreens": true,
          "DisplayOnMediumScreens": true,
          "DisplayOnLargeScreens": true,
          "ModuleSpecificSetting": null,
          "LicenseKeyRestriction": null,
          "FeatureDialogUrl": null
        }
      }
    ]
  },
  "Offset": 0,
  "Limit": 0,
  "Count": 1,
  "TotalCount": 1,
  "NextPageLink": null,
  "HasNext": false,
  "NextOffset": 0
}

2. Example PUT Request (Failing with 501):

We then attempt to update the ContentItem using the following PUT request:

URL: https://{my-imis-instance}/api/ContentItem/6bc5e0fa-2166-48e8-900c-aa8b30af033d
Method: PUT
Headers:
Content-Type: application/json
Accept: application/json

Body:

{
"$type": "Asi.Soa.Core.DataContracts.GenericExecuteRequest, Asi.Contracts",
"EntityTypeName": "Asi.Soa.Core.DataContracts.ContentItemData, Asi.Contracts",
"OperationName": "Update",
"Parameters": [
{
"ContentKey": "3ee09860-df89-4038-98ea-b3001e9ce8b2",
"ContentTypeKey": "47e1a269-dc81-44d9-b1c0-e26f91c4a2f8",
"ContentItemKey": "6bc5e0fa-2166-48e8-900c-aa8b30af033d",
"ShowTitleFlag": false,
"SortOrder": 1,
"LayoutZone": 1,
"ContentItemName": "Updated ContentBigButtonPanel",
"Links": [
{
"First": "@/PortalTest/About/About",
"Second": "Updated Event Search"
}
],
"ExistingLegacyBorder": "ExistingLegacyBorder"
}
],
"ParameterTypeNames": ["Asi.Soa.Core.DataContracts.ContentItemData, Asi.Contracts"],
"UseJson": true
}

This consistently returns a 501 Not Implemented error.

Questions:

Is the PUT method for ContentItem supported on our iMIS instance?
If it is supported, are there any specific configuration requirements or permissions that we might be missing?
Are there alternative methods, such as using the POST /api/ContentItem/_execute endpoint, that we should be using for updates? If so, could you please provide examples of the correct request body and OperationName?
Is there a specific version of iMIS that is required to use the PUT method?
We would appreciate any assistance you can provide in resolving this issue.

Thank you for your time and support.