Skip to main content

List Folders


Retrieve a list of folders.


HTTP Method: GET

Query ParameterDescription
team_idOptional ID of team to which the folders belongs.
content_typeOptional The type of content stored in the folders.
curl -X GET \  https://<tenant-domain>/api/v1/folders \  -H 'content-type: application/json' \  -H 'x-user-email: <email-address>' \  -H 'x-user-token: <api-token>'


A successful request will return a JSON Array describing folders in the Tines tenant.

Field description#

idThe folder ID.
nameThe folder name.
team_idID of team to which the folder belongs.
content_typeThe type of content stored in the folder
sizeThe number of items in this folder

Sample response#

{  "folders": [    {      "id": 1,      "name": "Credential folder",      "content_type": "CREDENTIAL",      "team_id": 1,      "size": 1    },    {      "id": 2,      "name": "Resource folder",      "content_type": "RESOURCE",      "team_id": 1,      "size": 1    },    {      "id": 3,      "name": "Story folder",      "content_type": "STORY",      "team_id": 1,      "size": 5    }  ],  "meta": {    "current_page": "https://<tenant-domain>/api/v1/folders?per_page=20&page=1",    "previous_page": null,    "next_page": null,    "per_page": 20,    "pages": 1,    "count": 3  }}