Rename or move an asset folder
Moving takes everything in it along. 409 `asset_folder_exists` for a name the destination has; 422 `asset_folder_cycle` when moving it into itself or a folder inside it; 422 `asset_folder_limit` past the depth.
Moving takes everything in it along. 409 asset_folder_exists for a name the destination has; 422 asset_folder_cycle when moving it into itself or a folder inside it; 422 asset_folder_limit past the depth.
apiKey writeAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
id*stringuuididempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
1 <= length <= 255application/json- body
name?string1 <= length <= 100parentId?|uuidOK
application/json- response
id*stringThe folder’s id
uuidname*stringparentId*|The folder it’s in; null at the top level
uuidimages*integerReady images directly in it
fonts*integerReady fonts directly in it
folders*integerFolders directly in it
createdAt*stringdate-timeupdatedAt*stringdate-timecurl -X PATCH 'https://api.postforge.dev/v1/asset-folders/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43", "images": 0, "fonts": 0, "folders": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}Create an asset folder POST
409 `asset_folder_exists` when the folder it’s in has one by that name; 422 `asset_folder_limit` past 1,000 folders or 10 levels.
Delete an asset folder DELETE
Deletes the folder and every folder inside it, and takes the assets in them out of the library like `DELETE /v1/assets/{id}` (archived: their files and URLs stay for emails that show them). The answer says how many of each went.