Create a Folder

Description

Create a folder in Tines.

Request

HTTP Method: POST

Query Parameter Description
name The folder name.
content_type The type of content stored in this folder CREDENTIAL RESOURCE or STORY
team_id ID of team to which the folder should be created.
parent_folder_id Optional ID of the parent folder. Default: null (root level).

Sample request

curl -X POST \
  https://<<META.tenant.domain>>/api/v1/folders/ \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'
  -d '{
      "name": "Folder name",
      "content_type": "CREDENTIAL",
      "team_id": 1,
      "parent_folder_id": 5
    }'

Response

A successful request will return a JSON object describing the created folder

Field description

Parameter Description
id The folder ID.
name The folder name.
team_id ID of team to which the folder belongs.
content_type The type of content stored in this folder
size The number of items in this folder
parent_folder_id ID of the parent folder, or null if at the root level.

Sample response

{
  "id": 1,
  "name": "Folder name",
  "content_type": "CREDENTIAL",
  "team_id": 1,
  "size": 0,
  "parent_folder_id": 5
}
Was this helpful?