## 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 Endpoints **GET** /v2.0/endpoints #### Try it ```bash curl --request GET \ --url https://api-trial.cognigy.ai/new/v2.0/endpoints \ --header 'X-API-Key: ' ``` ```python import requests url = "https://api-trial.cognigy.ai/new/v2.0/endpoints" 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/endpoints', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ```php "https://api-trial.cognigy.ai/new/v2.0/endpoints", 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/endpoints" 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/endpoints") .header("X-API-Key", "") .asString(); ``` ```ruby require 'uri' require 'net/http' url = URI("https://api-trial.cognigy.ai/new/v2.0/endpoints") 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 ``` #### Responses | Status Code | Description | |-------------|-------------| | 200 | Successful response. | | 400 | Bad Request. | | 401 | Unauthorized. | | 402 | Payment Required. | | 403 | Forbidden. | | 404 | Not Found. | | 405 | Method Not Allowed. | | 409 | Conflict. | | 413 | Payload Too Large. | | 500 | Internal Server Error. | | 501 | Not Implemented. | | 502 | Bad Gateway. | | 503 | Service Unavailable. | | 504 | Gateway Timeout. | ```json { "items": [ { "name": "New Endpoint", "flowId": "", "localeId": "", "URLToken": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f", "channel": "webchat3", "overrideSnapshotConnections": true, "_id": "", "createdAt": 1694518620, "lastChanged": 1694518620, "createdBy": "", "lastChangedBy": "" } ], "total": 1, "nextCursor": "", "previousCursor": "" } ``` ```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": {} } ``` ```json { "type": "Unauthorized", "title": "Unauthorized Error", "status": 401, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 401, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` ```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": {} } ``` ```json { "type": "Forbidden", "title": "Forbidden Error", "status": 403, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1000, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` ```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" } ``` ```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": {} } ``` ```json { "type": "Conflict", "title": "Conflict Error", "status": 409, "detail": "", "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432", "code": 1004, "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f", "details": {} } ``` ```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": {} } ``` ```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": {} } ``` ```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": {} } ``` ```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": {} } ``` ```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": {} } ``` ```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 - **API Key** - X-API-Key: string, header, required #### Headers - Accept: - enum, default: application/json #### Query Parameters - projectId: string, required, length: 24, pattern: ^[a-z0-9]{24}$ - filter: string - limit: integer, range: 1 <= x <= 100, default: 25 - skip: integer, range: x >= 0, default: 0 - sort: string, minimum length: 1 - next: string, required string length: 24 - previous: string, required string length: 24 ### Response #### 200 - application/json - Returns array of Endpoint metadata objects #### Items - object[] `items` #### Total - integer `total` #### Cursors - string `nextCursor` | null - string `previousCursor` | null Last modified on July 8, 2026