Create Folder Rest API does not set title for the new folder | Community
Skip to main content
P
PhillipKo
Level 2
May 3, 2024
Solved

Create Folder Rest API does not set title for the new folder

  • May 3, 2024
  • 5 replies
  • 1878 views

Hello,

 

I am using the Rest API to interact with our AEM as a Cloud Service environment.  When I attempt to use the create folder api, I cant get it to set the Title correctly.

 

For instance, I used the following request:

POST https://author-xxxxxx-xxxxxxxx.adobeaemcloud.com/content/dam/myfolder

Request Body (Content Type = application/json):

{
    "class": "assetFolder",
    "properties": {
        "title": "My Folder"
    }
}

 

This creates the folder with the correct name, but does not set the title.  I tried using jcr:title instead of title in the request, still does not set the title.  I even tried dc:title...nothing seems to work.

I even tried to use the API that ends with a wildcard (and uses a multi-part form body), but that one is even worse because it sets the title correctly, but does not use the name request parameter to create folder name (instead using the title request parameter while replacing spaces with underscores).

 

Has anyone been able to get this to work correctly?

 

Thanks,

Phil

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.
Best answer by EstebanBustamante

Which API are you using? 
If you are using the "assets API", then your request URL is not correctly formed, you are missing the "/api/assets" part of it.
If you are using the new experimental folders API, you should give it a try in the playground directly: https://developer.adobe.com/experience-cloud/experience-manager-apis/api/experimental/folders/ 

Hope this helps.

5 replies

HrishikeshKagne
Community Advisor
HrishikeshKagneCommunity Advisor
Community Advisor
May 4, 2024

Hi @phillipko ,

It seems you're encountering an issue with setting the title of a folder when creating it via the AEM REST API. Let's try to troubleshoot and find a solution.

  1. Check API Documentation: First, ensure that you are using the correct API endpoint and request payload. Refer to the official Adobe documentation or API reference to verify the correct syntax for creating a folder with a specific title.

  2. Payload Structure: Make sure the payload structure is correct. In your case, the payload seems appropriate, with "class": "assetFolder" specifying that it's an asset folder and "properties" containing the properties you want to set.

  3. Property Name: The property for the folder's title might vary depending on the AEM version and configuration. While "title" is commonly used, it's worth checking the documentation or inspecting the properties of an existing folder to confirm the correct property name.

  4. Alternative Approach: If setting the title directly doesn't work, you might try updating the folder's properties after creation using a separate API call. This approach involves retrieving the newly created folder's path and then updating its properties, including the title.

  5. Testing with Different Property Names: Since "title", "jcr:title", and "dc:title" didn't work for you, it might be worth experimenting with other potential property names. You could try "name" or "displayName" to see if they have any effect.

  6. Reach Out to Adobe Support: If you've tried different approaches and none of them seem to work, consider reaching out to Adobe Support for assistance. They might be able to provide insights or solutions specific to your AEM environment or configuration.

By exploring these steps and potentially combining different approaches, you should be able to resolve the issue with setting the title of a folder via the AEM REST API.

Hrishikesh Kagane
    sravs
    Community Advisor
    sravsCommunity Advisor
    Community Advisor
    May 6, 2024

    Hi @phillipko , 

    Folders

    Folders are like directories as in the traditional file systems. Folder can contain just assets, just folders, or folders and assets. Folders have the following components:

    Entities: The entities of a folder are its child elements, which can be folders and assets.

    Properties:

    • name is the name of the folder. This is the same as the last segment in the URL path without the extension.
    • title is an optional title of the folder which can be displayed instead of its name.

     

    I'm able to set the title for the folder with the following, please validate once with your request.

     

    Post http://localhost:4502/api/assets/test/mytestfolder

    RequestBody 

    {"class":"assetFolder","properties":{"title":"My Test Folder", "jcr:title":"Test Folder"}}
     

     

     
    This sets both title and jcr:title for the folder. Please refer for more details 
      EstebanBustamante
      Community Advisor and Adobe Champion
      EstebanBustamanteCommunity Advisor and Adobe ChampionAccepted solution
      Community Advisor and Adobe Champion
      May 6, 2024

      Which API are you using? 
      If you are using the "assets API", then your request URL is not correctly formed, you are missing the "/api/assets" part of it.
      If you are using the new experimental folders API, you should give it a try in the playground directly: https://developer.adobe.com/experience-cloud/experience-manager-apis/api/experimental/folders/ 

      Hope this helps.

      Esteban Bustamante
        P
        PhillipKoAuthor
        Level 2
        May 10, 2024

        Thanks Esteban - you are correct.....I was using /dam/content instead of /api/assets in my URL.  Once I switched that, everything worked as expected.

          kautuk_sahni
          Community Manager
          kautuk_sahniCommunity Manager
          Community Manager
          June 7, 2024

          @phillipko I trust the AEM community has been helpful to you. We look forward to seeing you back as either a learner or a mentor. The community thrives with SMEs like you. Please invite your AEM peers to contribute too. Happy AEM learning!

          Kautuk Sahni
          varun_m1
          varun_m1
          Level 2
          May 8, 2024

          Hi @phillipko ,

          I could create a folder and set its title with the following postman request using assets http API,

          Authorization is basic with username and password.

          I got the below response,

           

          { "class": [ "core/response" ], "properties": { "path": "/api/assets/new folder/*", "parentLocation": "/api/assets/new%20folder.json", "referer": "", "isCreate": true, "changes": [ { "argument": "/api/assets/new folder/Hello world", "type": "created" } ], "location": "/api/assets/new%20folder/Hello%20world.json", "status.message": "Created", "title": "Content created /api/assets/new folder/*", "status.code": 201 } }

           

          and I could check the folder created in CRXDE Lite,

          This works as expected. Let me know if you need any more information on this.

            P
            PhillipKoAuthor
            Level 2
            May 10, 2024

            Thanks for all the helpful information and guidance everyone!   I am a newbie to developing in the AEM environment and appreciate all the support!

              Terms & ConditionsAccessibility statement

              Loading footer...