curl -X POST https://api.getversive.com/api/v1/folders \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Q3 churn research", "retention_policy_days": 30 }'
{
"id": "<string>",
"name": "<string>",
"created_at": "<string>",
"retention_policy_days": {}
}Folders
Create folder
Create a folder for organizing studies
POST
/
folders
curl -X POST https://api.getversive.com/api/v1/folders \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Q3 churn research", "retention_policy_days": 30 }'
{
"id": "<string>",
"name": "<string>",
"created_at": "<string>",
"retention_policy_days": {}
}Creates a folder. Returns
201.
string
required
The folder name.
string
default:"FULL_ACCESS"
FULL_ACCESS, CAN_EDIT, CAN_VIEW, INVITE_ONLY, or CAN_EDIT_SURVEY_ONLY.integer | null
default:"null"
Days to keep interview transcripts in this folder’s studies, from 1 to 36500, counted from each interview’s last message. After that the transcript and the study memory learned from it are deleted.
null keeps transcripts indefinitely. Over an MCP connection, only the organization owner can set it. See Transcript retention.Response
string
string
string
integer | null
curl -X POST https://api.getversive.com/api/v1/folders \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Q3 churn research", "retention_policy_days": 30 }'