curl -X PATCH https://api.getversive.com/api/v1/folders/5c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "retention_policy_days": 30 }'
{
"id": "<string>",
"name": "<string>",
"created_at": "<string>",
"retention_policy_days": {}
}Folders
Update folder
Rename a folder or set its transcript retention policy
PATCH
/
folders
/
{id}
curl -X PATCH https://api.getversive.com/api/v1/folders/5c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "retention_policy_days": 30 }'
{
"id": "<string>",
"name": "<string>",
"created_at": "<string>",
"retention_policy_days": {}
}Updates only the fields you send.
string
required
The folder ID.
string
New folder name.
integer | null
Days to keep interview transcripts in this folder’s studies, from 1 to 36500, counted from each interview’s last message. Send
null to turn retention off. Setting it on a folder with existing studies deletes their transcripts older than the window at the next hourly check. See Transcript retention for what is deleted and kept.Organization API keys can change this field. Over an MCP connection, only the organization owner can.Response
string
string
string
integer | null
curl -X PATCH https://api.getversive.com/api/v1/folders/5c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "retention_policy_days": 30 }'