Folders · OwnMediaHost Docs

`GET /api/v1/folders`

List all folders with media counts.

Auth required: Yes

bash

curl -H "X-API-Key: YOUR_KEY" https://api.example.com/api/v1/folders

Response:

json

{
  "success": true,
  "data": [
    {
      "id": "fld_abc",
      "name": "Portfolio",
      "parent_id": null,
      "media_count": 24,
      "created_at": "2026-09-10T10:00:00Z",
      "updated_at": "2026-09-19T14:00:00Z"
    }
  ]
}

`POST /api/v1/folders`

Create a new folder.

Auth required: Yes

bash

curl -X POST https://api.example.com/api/v1/folders \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Screenshots", "parent_id": null}'

`PATCH /api/v1/folders/{id}`

Rename or move a folder.

Auth required: Yes

bash

curl -X PATCH https://api.example.com/api/v1/folders/fld_abc \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Renamed Folder"}'

`DELETE /api/v1/folders/{id}`

Delete a folder. Files inside are unassigned to root, not deleted.

Auth required: Yes

bash

curl -X DELETE https://api.example.com/api/v1/folders/fld_abc \
  -H "X-API-Key: YOUR_KEY"