Expand my Community achievements bar.

Submissions are now open for the 2026 Adobe Experience Maker Awards.

Attempting To Create AEM Folder Gives 409

Avatar

Level 1

I am attempting to create a new folder in the AEM cloud utilizing the assets/api. This is my payload

https://author-<author>.adobeaemcloud.com/api/assets/parentPath/*

 

Headers

Content-Type=application/x-www-form-urlencoded

Authorization=Bearer <token>

 

Request

name=test-folder

jcr:title=test-folder

class=assetFolder

 

When I run this, I get this error 

 

{
	"class": [
		"core/response"
	],
	"properties": {
		"path": "/api/assets/parent/*",
		"parentLocation": "/api/assets/parent.json",
		"referer": "",
		"changes": [],
		"location": "/api/assets/parent/*.json",
		"status.message": "Resource /api/assets/parent/* already exist.",
		"status.code": 409
	}
}

 

I have also tried the json request utilizing https://author-<author>.adobeaemcloud.com/api/assets/parentPath/test-folder, which gives me a 200 OK message, but does not give me the 201 created message, and the "changes" field is still empty. Any help would be great. Thank you! 

Topics

Topics help categorize Community content and increase your ability to discover relevant content.

9 Replies

Avatar

Community Advisor

Hi @ColtSm,

I think the error you're getting is because you're trying to create a folder using an invalid path - the * in the URL (/api/assets/parentPath/*) isn’t allowed, and it's probably treating it like the folder already exists. Have you tried without *?

Try to use the actual parent folder path where you want to create your new folder. For example, if you want to create the folder under /content/dam, your request should look like this:

URL: https://author-<author>.adobeaemcloud.com/api/assets/content/dam


Headers:

  • Content-Type: application/json

  • Authorization: Bearer <your_token>

Body:

{
  "name": "test-folder",
  "jcr:title": "test-folder",
  "class": "assetFolder"
}

Also, make sure the folder doesn’t already exist - if it does, you'll get a 409 Conflict. Try using a different folder name to test.

Hope that helps!

Regards,
Santosh


Santosh Sai

AEM BlogsLinkedIn


Avatar

Level 1

Hi @SantoshSai,

 

Thanks for getting back to me on this. When I use /api/assets/content/dam I get a path not found error, which implies there is no /api/assets/content/dam. When I try to POST to /api/assets/<myparent>, using the credentials it should create a new folder under the <myparent> directory, correct? Or should I be trying to POST to /api/assets/<myparent>/test-folder? Either way it does not work, as the former returns a 409 conflict, as I showed before (saying that /api/assets/<myparent> already exists), and the latter returns a 200 with no changes, rather than a 201 created.  

Avatar

Community Advisor

Hi @ColtSm ,

Here is an example curl 

curl --location 'https://author-**-**.adobeaemcloud.com/api/assets/web/myfoldername/*' \
--header 'Authorization: **' \
--header 'Content-Type: application/json' \
--data '{"properties":{"name":"newfolder","jcr:title":"jcrtitle"}}'

This will create a folder at `/content/dam/web/myfoldername/newfolder` Make sure its POST request. This should work like this 

sarav_prakash_0-1744937530775.png

 

 

Avatar

Level 1

Hi @sarav_prakash,

 

Thank you for reaching out. Using this request still gives me the 409 error. My company does not use /assets/api/web, so that returned a "parent not found". Using the path to our parent folder, which is at /assets/api/<folder>/, this is what my request returned. 

ColtSm_0-1744940919916.png

ColtSm_1-1744940986272.png

 

 

Avatar

Community Advisor

I gave `/assets/api/web` aka `/content/dam/web` folder as example. Not todo with your token. 409 is conflict, meaning the folder already exists in AEM. You are sure, under your /content/dam/parent/test-folder is not present? Can you try changing `name:test-folder` to like `name:testfolder1234`? 

Avatar

Level 1

Yes, I am sure. Here is my payload with a different name 

 

ColtSm_0-1744945519013.png

 

you can see that the path that it is saying "already exists" is /api/assets/parent/*.json. It seems to be trying to create a folder called *.json, instead of the folder in my request. 

Avatar

Community Advisor

I see. This is weird, some job/launcher/listener, something is racing ahead of  your Assets API. This is this not OOTB. You may need to try under different root like /content/dam/new. Or try to spin new RDE/local environment, donot deploy any custom code and try Assets API. On vanilla instance, Assets API works.

 

Alternate, if assets API is troubling, AEM is moving to OpenAPI. You can this experimental API. 

https://developer.adobe.com/experience-cloud/experience-manager-apis/api/experimental/folders/

 Longterm, OpenAPI will takeover. Request looks like this 

sarav_prakash_0-1744977722855.png

No hassle of splitting parent folder and child folder in path and body. 

 

Avatar

Administrator

@ColtSm Just checking in — were you able to resolve your issue?
We’d love to hear how things worked out. If the suggestions above helped, marking a response as correct can guide others with similar questions. And if you found another solution, feel free to share it — your insights could really benefit the community. Thanks again for being part of the conversation!



Kautuk Sahni

Avatar

Level 1

Hi Kautuk, 

 

No, unfortunately this issue was not resolved, even after opening a ticket directly with adobe through my company. We decided to switch software as the API for cloud did not work, in addition to other limitations of AEMaaCS. Thank you for your help, though!