Wipe Database | Captain Docs

Remove all indexed files from a database while keeping the database structure.

Headers:

Authorization: Bearer {api_key} - Captain API key for authentication
X-Organization-ID: Organization UUID

Use cases:

Clear old indexed content before re-indexing
Reset a database to empty state
Remove dataset while keeping database configuration

Args: database_name: Name of the database to clear

Returns: Response with count of files removed

Remove all indexed files from a database while keeping the database structure. Headers: - Authorization: Bearer {api_key} - Captain API key for authentication - X-Organization-ID: Organization UUID Use cases: - Clear old indexed content before re-indexing - Reset a database to empty state - Remove dataset while keeping database configuration Args: database_name: Name of the database to clear Returns: Response with count of files removed

Headers

AuthorizationstringRequired

Captain API key for authentication

X-Organization-IDstringRequired

Organization UUID

Request

This endpoint expects an object.

database_namestringRequired

Response

Successful Response

successboolean

messagestring

errorstring or null

1	import requests
2
3	BASE_URL = "https://api.runcaptain.com"
4	API_KEY = "your_api_key"
5	ORG_ID = "your_organization_id"
6
7	headers = {
8	"Authorization": f"Bearer {API_KEY}",
9	"X-Organization-ID": ORG_ID,
10	"Content-Type": "application/x-www-form-urlencoded"
11	}
12
13	response = requests.post(
14	f"{BASE_URL}/v1/wipe-database",
15	headers=headers,
16	data={"database_name": "my_documents"},
17	timeout=30.0
18	)
19
20	if response.status_code == 200:
21	result = response.json()
22	print(f"Database wiped! Files deleted: {result.get('files_deleted', 0)}")
23	else:
24	print(f"Error: {response.status_code}")
25	print(response.json())

1	{
2	"success": true,
3	"message": "File deleted successfully"
4	}

Headers

Request

Response

Errors