Create Collection | Captain Docs

Create a new collection (idempotent). Returns 201 if created, 200 if already exists.

Headers:

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

Returns:

CollectionResponse with collection details

Create a new collection (idempotent). Returns 201 if created, 200 if already exists. Headers: - Authorization: Bearer {api_key} - Captain API key for authentication - X-Organization-ID: Organization UUID Returns: - CollectionResponse with collection details

Path parameters

collection_namestringRequired

Name of the collection to create

Request

This endpoint expects an object.

descriptionstringOptional

Response

Collection Already Exists

collection_namestring

collection_idstring

statusstring

messagestring

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/json"
11	}
12
13	response = requests.put(
14	f"{BASE_URL}/v2/collections/my_documents",
15	headers=headers,
16	json={},
17	timeout=30.0
18	)
19
20	if response.status_code == 201:
21	print("Collection created successfully!")
22	elif response.status_code == 200:
23	print("Collection already exists")
24	print(response.json())

1	{
2	"collection_name": "my_documents",
3	"collection_id": "col_abc123",
4	"status": "exists",
5	"message": "Collection already exists"
6	}