Delete a folder and everything in it
DELETE /voice/collections/{collection_id}/folders
DELETE
/voice/collections/{collection_id}/folders
SPENDS NOTHING. IRREVERSIBLE: removes the folder’s files from storage, the database and the vector index, so agents stop answering from them.
Ownership is checked FIRST: voice’s handler selects the files by collection id alone, so without this a guessed id would reach another tenant’s files. Another tenant’s collection is a 404.
Authorizations
Parameters
Path Parameters
collection_id
required
Collection id.
integer
Collection id.
Query Parameters
folder_path
required
The folder; subfolders go too.
string
The folder; subfolders go too.
Header Parameters
Responses
200
Successful Response
object
data
required
One voice object - a collection, an agent, a route, a chat.
Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.
object
key
additional properties
any
pagination
Any of:
object
has_next
required
Whether there are more pages
boolean
limit
required
Items per page
integer
notes
Any of:
Array<string>
null
page
required
Current page number (1-indexed)
integer
total
required
Total number of items
integer
null
422
Validation Error
object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string