API Reference

Folders

The file manager’s folder tree.

Prefix /cdna-api/files ReferenceFolder model GuideFiles Manager

List folders#

GET /cdna-api/files/folders

Lists folders. Without limit every match comes back.

Access
Admin users and integrations, with an OAuth access token or an API key.
Model
Folder, in the Reference

Parameters

propertiesquery
selector
The fields and relations to return, such as {id,name,path}.
filtersquery
name=value
Any stored field, or a relation with a dot, such as parent.id=12. Prefix the name with !, >, <, % or |. Use stored field names exactly as in the model, and compare totalCount with the unfiltered list's to confirm a filter applied.
orderByquery
string
field:ASC or field:DESC, comma-separated. Stored fields only.
limitquery
integer
Records per response. There is no default.
offsetquery
integer
Records to skip.

Example

List folders 
GET /cdna-api/files/folders?limit=2&properties={id,name,path} HTTP/1.1
Host: hub.coredna.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept: application/json
Response 200 OK 
{
  "result": "success",
  "totalCount": 258,
  "data": [
    {
      "id": 1,
      "name": "6",
      "path": "images/blogs/6"
    },
    {
      "id": 2,
      "name": "blogs",
      "path": "images/blogs"
    }
  ]
}
Real response from this documentation site

Show a folder#

GET /cdna-api/files/folder/{id}

Reads one folder by its id.

Access
Admin users and integrations, with an OAuth access token or an API key.
Model
Folder, in the Reference

Parameters

idpathrequired
integer
The folder id.
propertiesquery
selector
The fields and relations to return, such as {id,name,path,parent{id}}.

Example

Show a folder 
GET /cdna-api/files/folder/1?properties={id,name,path,parent{id}} HTTP/1.1
Host: hub.coredna.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept: application/json
Response 200 OK 
{
  "result": "success",
  "data": {
    "id": 1,
    "name": "6",
    "path": "images/blogs/6",
    "parent": {
      "id": 2
    }
  }
}
Real response from this documentation site

Create a folder#

POST /cdna-api/files/folder

Creates a folder.

Access
Admin users and integrations, with an OAuth access token or an API key.
Returns
The new folder under data.folder, and a message.

Parameters

namebodyrequired
string
The folder’s name.
parentbody
integer
The folder it sits in.

Example

Create a folder 
POST /cdna-api/files/folder HTTP/1.1
Host: hub.coredna.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept: application/json
Content-Type: application/json

{
  "name": "brochures",
  "parent": 3
}

Edit a folder#

PUT /cdna-api/files/folder/{id}

Changes a folder. Fields left out keep their values.

Access
Admin users and integrations, with an OAuth access token or an API key.
Returns
The saved folder under data.folder, and a message.

Parameters

idpathrequired
integer
The folder id.
name, parentbody
As for Create a folder; a new parent moves it.

Example

Edit a folder 
PUT /cdna-api/files/folder/300 HTTP/1.1
Host: hub.coredna.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept: application/json
Content-Type: application/json

{
  "name": "brochures-2026"
}

Delete a folder#

DELETE /cdna-api/files/folder/{id}

Deletes a folder.

Access
Admin users and integrations, with an OAuth access token or an API key.

Parameters

idpathrequired
integer
The folder id.

Example

Delete a folder 
DELETE /cdna-api/files/folder/300 HTTP/1.1
Host: hub.coredna.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept: application/json