Create a new knowledge base

POST 
/ai/knowledgebases

Creates an unstructured (vector RAG) or structured (SQL) knowledge base in Bedrock and DynamoDB. KnowledgebaseName is required and must be unique. Defaults to unstructured, which also requires EmbeddingModel. Structured requires DataStoreType; TenantName is required for redshift when multi-tenancy is enabled. Account limit is 100 knowledge bases. A 200 response means creation was initiated (unstructured) or datastore setup is in progress (structured).

Request

Responses

200

Creation initiated. Unstructured Message is "Knowledge base creation initiated."; structured Message is "Knowledge base creation successful. Data store setup is in progress." Both include KnowledgebaseId.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation or authorization failure. Body is {"Message": " - "}. Codes: IPV-1008 (missing/invalid fields or account quota), IPV-1018 (duplicate KnowledgebaseName), IPV-1020 (wrong field type), IPV-1041 (invalid DataStoreType), RS-1020 (invalid TenantName), GE-1034 (Bedrock quota exceeded), AI-1004 (AICore disabled), AUTH-1001 (missing role_id), AUTH-1011 (caller not authorized).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Codes: GE-1085 (unexpected backend failure), DB-1002 (persistence failure).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers