Appearance
Search
About 260 wordsLess than 1 minute
apiFiles
2026-09-01
Searches the display names (titles) of items the caller can read in /public, the caller's home folder, and the analysis models. Matching is case-insensitive and finds the keyword anywhere in the title. Results are a flat list.
| Method and path | GET /plugin/datafor-modeler/api/repo/files/search |
| Permission | Any signed-in user; only readable items are returned |
| Content type | none (query string) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
word | query | string | Yes | Keyword. An empty value returns every readable item. |
showHidden | query | boolean | No | Default false. Include hidden items. |
includeAccessMap | query | boolean | No | Default false. Compute which of the permissions the caller has on each item. |
permissions | query | string | No | Default 0|1|2|4 (Read, Edit, Delete, Full control). |
includeMetadata | query | boolean | No | Default false. Compute the item's metadata. |
includeAcls | query | boolean | No | Default false. Include each item's ACL. |
includeSysDirs | query | boolean | No | Default false. Include system folders. |
Example
curl -u admin:password -G \
"http://localhost:28080/datafor/plugin/datafor-modeler/api/repo/files/search" \
--data-urlencode "word=revenue"{
"success": true,
"data": [
{
"name": "Revenue.datafor",
"id": "66666666-7777-8888-9999-000000000000",
"path": "/public/Sales/Revenue.datafor",
"title": "Revenue",
"folder": false,
"fileSize": 4120,
"creatorId": "admin",
"createdDate": "1759900100000",
"lastModifiedDate": "1759986500000"
},
{
"name": "Revenue",
"id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"path": "/etc/mondrian/Revenue",
"title": "Revenue",
"folder": true
}
]
}Analysis models appear as folders under /etc/mondrian.
Related: Get file tree, Quick tour of the console