Description

Use a HTTP POST request to create a folder.

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.

Sample request

curl -X POST \
  https://<tenant-name>.tines.io/api/v1/folders/ \
  -H 'content-type: application/json' \
  -H 'x-user-email: <email-address>' \
  -H 'x-user-token: <api-token>'
  -d '{
      "name": "Folder name",
      "content_type": "CREDENTIAL",
      "team_id": 1,
    }'

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

Sample response

{
  "id": 1,
  "name": "Folder name",
  "content_type": "CREDENTIAL",
  "team_id": 1,
  "size": 0
}