## Documentation Index Fetch the complete documentation index at: [/llms.txt](https://docs.cognigy.com/llms.txt) Use this file to discover all available pages before exploring further. GET /v2.0/knowledgestores/{knowledgeStoreId} ### Try it #### Get a Knowledge Store **cURL** ```bash curl --request GET \ --url https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId} \ --header 'X-API-Key: ' ``` ```python import requests url = "https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId}" headers = {"X-API-Key": ""} response = requests.get(url, headers=headers) print(response.text) ``` ```javascript const options = {method: 'GET', headers: {'X-API-Key': ''}}; fetch('https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId}', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ```php "https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId}",\ CURLOPT_RETURNTRANSFER => true,\ CURLOPT_ENCODING => "",\ CURLOPT_MAXREDIRS => 10,\ CURLOPT_TIMEOUT => 30,\ CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\ CURLOPT_CUSTOMREQUEST => "GET",\ CURLOPT_HTTPHEADER => [\ "X-API-Key: "\ ],\ ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ?> ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId}" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-API-Key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ```java HttpResponse response = Unirest.get("https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId}") .header("X-API-Key", "") .asString(); ``` ```ruby require 'uri' require 'net/http' url = URI("https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-API-Key"] = '' response = http.request(request) puts response.read_body ``` ### Response **200** ```json { "name": "mystore", "description": "mystore description", "language": "en-US", "documents": [ "https://some-website.com/knowledgebase.txt" ], "referenceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "_id": "", "createdAt": 1694518620, "lastChanged": 1694518620, "createdBy": "", "lastChangedBy": "" } ``` #### Error Responses **400 Bad Request** ```json { "type": "Bad Request", "title": "Bad Request Error", "status": 400, "detail": "Validation failed. Missing payload.", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **401 Unauthorized** ```json { "type": "Unauthorized", "title": "Unauthorized Error", "status": 401, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 401, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **402 Payment Required** ```json { "type": "Payment Required", "title": "Payment Required Error", "status": 402, "detail": "Validation failed. Missing payload.", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 402, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **403 Forbidden** ```json { "type": "Forbidden", "title": "Forbidden Error", "status": 403, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **404 Not Found** ```json { "type": "Not Found", "title": "Not Found Error", "status": 404, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {}, "logLevel": "error" } ``` **405 Method Not Allowed** ```json { "type": "Method Not Allowed", "title": "Method Not Allowed Error", "status": 405, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **409 Conflict** ```json { "type": "Conflict", "title": "Conflict Error", "status": 409, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1004, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **413 Payload Too Large** ```json { "type": "Payload Too Large", "title": "Payload Too Large Error", "status": 413, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **500 Internal Server Error** ```json { "type": "Internal Server Error", "title": "Internal Server Error", "status": 500, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **501 Not Implemented** ```json { "type": "Not Implemented", "title": "Not Implemented Error", "status": 501, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1009, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **502 Bad Gateway** ```json { "type": "Bad Gateway", "title": "Bad Gateway Error", "status": 502, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **503 Service Unavailable** ```json { "type": "Service Unavailable", "title": "Service Unavailable Error", "status": 503, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 503, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` **504 Gateway Timeout** ```json { "type": "Gateway Timeout", "title": "Gateway Timeout Error", "status": 504, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` ### Authorizations **APIKeyHeaderAPIKeyQueryParamCXoneTokenHeaderOAuth2APIKeyHeaderAPIKeyQueryParamCXoneTokenHeaderOAuth2** **X-API-Key** string header required Supply the API Key in the HTTP-Header ### Headers **Accept** enum The `Accept` header specifies the media type that the client expects in the response. Available options: `application/json`, `application/hal+json`, `application/xml`, `text/xml`, `text/csv`. The default value is `application/json`.