Skip to main content
PUT
/
folders
/
{folder_token}
Update folder
curl --request PUT \
  --url https://api.vantage.sh/v2/folders/{folder_token} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "parent_folder_token": "<string>",
  "saved_filter_tokens": [
    "<string>"
  ]
}
'
{
  "token": "fldr_68e18d8d7df0be96",
  "title": "New Title",
  "parent_folder_token": "fldr_9aa0c735a6b615c6",
  "created_at": "2023-09-12T05:06:53Z",
  "updated_at": "2023-09-12T05:06:53Z",
  "workspace_token": "wrkspc_e65a48e5d9684439"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
folder_token
string
required

Body

application/json

Update a Folder for CostReports.

​
title
string

The title of the Folder.

​
parent_folder_token
string

The token of the parent Folder.

​
saved_filter_tokens
string[]

The tokens of the SavedFilters to apply to any Cost Report contained within the Folder.

Response

Folder model

​
token
string
​
title
string

The title of the Folder.

Example:

"Platform Team Reports"

​
parent_folder_token
string

The token for the parent Folder, if any.

​
saved_filter_tokens
string[]

The tokens for the SavedFilters assigned to the Folder.

​
created_at
string

The date and time, in UTC, the Folder was created. ISO 8601 Formatted.

Example:

"2023-08-04T00:00:00Z"

​
updated_at
string

The date and time, in UTC, the Folder was last updated at. ISO 8601 Formatted.

Example:

"2023-08-04T00:00:00Z"

​
workspace_token
string

The token for the Workspace the Folder is a part of.