Create Collection | Captain Docs

Create a collection by name. The request is idempotent for an existing collection.

collection_namestringRequired

This endpoint expects a nullable object.

descriptionstring or nullOptional

metadataobject or nullOptional

Successful Response

collection_idstring

collection_namestring

organization_idstring

created_atstring or null

descriptionstring or null

metadataobject or null

1	import json
2	import requests
3	import uuid
4
5	BASE_URL = "https://api.runcaptain.com"
6	API_KEY = "your_api_key"
7	COLLECTION_NAME = "my_documents"
8
9	headers = {
10	"Authorization": f"Bearer {API_KEY}",
11	"Content-Type": "application/json",
12	"Idempotency-Key": str(uuid.uuid4()),
13	}
14
15	response = requests.put(
16	f"{BASE_URL}/v2/collections/{COLLECTION_NAME}",
17	headers=headers,
18	json={
19	"description": "example_description",
20	"metadata": {}
21	},
22	timeout=30.0
23	)
24
25	print(json.dumps(response.json(), indent=2))