---
agentTools:
  projectIndex: https://kentro.readme.io/llms.txt
---

# check API credentials

Check if API credentials are valid.

# OpenAPI definition

```json
{
  "servers": [
    {
      "url": "https://api.kentro.dev",
      "description": "Sandbox"
    },
    {
      "url": "https://api.kentro.live",
      "description": "Production"
    }
  ],
  "info": {
    "title": "Utils API",
    "version": "1.149.3",
    "description": "Your one-stop-shop for utilities and miscellaneous services. From setting up REST hooks to data fetching and triggering adapter events, Utils-API bridges the gaps that don't fit into any other category.",
    "termsOfService": "https://kentro.io/terms-and-conditions",
    "contact": {
      "name": "support",
      "url": "https://kentro.io/contact-us",
      "email": "support@kentro.io"
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "x-proxy-enabled": true,
    "proxy-enabled": true
  },
  "paths": {
    "/v1/utils/check-api-credentials": {
      "post": {
        "parameters": [],
        "responses": {
          "201": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1_utils_check-api-credentials_createResponse"
                }
              }
            }
          },
          "401": {
            "description": "Request is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "The error name"
                    },
                    "message": {
                      "type": "string",
                      "description": "The error message"
                    },
                    "code": {
                      "type": "number",
                      "description": "An HTTP error code"
                    },
                    "className": {
                      "type": "string",
                      "description": "The full name of the error class"
                    },
                    "data": {
                      "type": "object",
                      "description": "Additional data to include in the error"
                    },
                    "errors": {
                      "type": "object",
                      "description": "Error object"
                    }
                  },
                  "required": [
                    "name",
                    "message",
                    "code",
                    "className",
                    "data",
                    "errors"
                  ],
                  "example": {
                    "name": "NotAuthenticated",
                    "message": "error message",
                    "code": 401,
                    "className": "not-authenticated",
                    "data": {
                      "key": "value"
                    },
                    "errors": {
                      "key": "value"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Request is forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "The error name"
                    },
                    "message": {
                      "type": "string",
                      "description": "The error message"
                    },
                    "code": {
                      "type": "number",
                      "description": "An HTTP error code"
                    },
                    "className": {
                      "type": "string",
                      "description": "The full name of the error class"
                    },
                    "data": {
                      "type": "object",
                      "description": "Additional data to include in the error"
                    },
                    "errors": {
                      "type": "object",
                      "description": "Error object"
                    }
                  },
                  "required": [
                    "name",
                    "message",
                    "code",
                    "className",
                    "data",
                    "errors"
                  ],
                  "example": {
                    "name": "Forbidden",
                    "message": "error message",
                    "code": 403,
                    "className": "forbidden",
                    "data": {
                      "key": "value"
                    },
                    "errors": {
                      "key": "value"
                    }
                  }
                }
              }
            }
          },
          "405": {
            "description": "Request method is not allowed on this endpoint",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "The error name"
                    },
                    "message": {
                      "type": "string",
                      "description": "The error message"
                    },
                    "code": {
                      "type": "number",
                      "description": "An HTTP error code"
                    },
                    "className": {
                      "type": "string",
                      "description": "The full name of the error class"
                    },
                    "data": {
                      "type": "object",
                      "description": "Additional data to include in the error"
                    },
                    "errors": {
                      "type": "object",
                      "description": "Error object"
                    }
                  },
                  "required": [
                    "name",
                    "message",
                    "code",
                    "className",
                    "data",
                    "errors"
                  ],
                  "example": {
                    "name": "MethodNotAllowed",
                    "message": "error message",
                    "code": 405,
                    "className": "method-not-allowed",
                    "data": {
                      "key": "value"
                    },
                    "errors": {
                      "key": "value"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Request is unprocessable",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "The error name"
                    },
                    "message": {
                      "type": "string",
                      "description": "The error message"
                    },
                    "code": {
                      "type": "number",
                      "description": "An HTTP error code"
                    },
                    "className": {
                      "type": "string",
                      "description": "The full name of the error class"
                    },
                    "data": {
                      "type": "object",
                      "description": "Additional data to include in the error"
                    },
                    "errors": {
                      "type": "object",
                      "description": "Error object"
                    }
                  },
                  "required": [
                    "name",
                    "message",
                    "code",
                    "className",
                    "data",
                    "errors"
                  ],
                  "example": {
                    "name": "Unprocessable",
                    "message": "error message",
                    "code": 422,
                    "className": "unprocessable",
                    "data": {
                      "key": "value"
                    },
                    "errors": {
                      "key": "value"
                    }
                  }
                }
              }
            }
          }
        },
        "description": "Check if API credentials are valid.",
        "summary": "check API credentials",
        "tags": [
          "check-api-credentials"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1_utils_check-api-credentials_createRequest"
              }
            }
          }
        },
        "x-code-samples": [
          {
            "lang": "Node + Request",
            "source": "const request = require('request');\n\nconst options = {\n  method: 'POST',\n  url: 'https://api.kentro.dev/v1/utils/check-api-credentials',\n  headers: {'content-type': 'application/json'},\n  body: {key: 'string', secret: 'string'},\n  json: true\n};\n\nrequest(options, function (error, response, body) {\n  if (error) throw new Error(error);\n\n  console.log(body);\n});\n"
          },
          {
            "lang": "Python + Python3",
            "source": "import http.client\n\nconn = http.client.HTTPSConnection(\"api.kentro.dev\")\n\npayload = \"{\\\"key\\\":\\\"string\\\",\\\"secret\\\":\\\"string\\\"}\"\n\nheaders = { 'content-type': \"application/json\" }\n\nconn.request(\"POST\", \"/v1/utils/check-api-credentials\", payload, headers)\n\nres = conn.getresponse()\ndata = res.read()\n\nprint(data.decode(\"utf-8\"))"
          },
          {
            "lang": "Ruby + Native",
            "source": "require 'uri'\nrequire 'net/http'\nrequire 'openssl'\n\nurl = URI(\"https://api.kentro.dev/v1/utils/check-api-credentials\")\n\nhttp = Net::HTTP.new(url.host, url.port)\nhttp.use_ssl = true\nhttp.verify_mode = OpenSSL::SSL::VERIFY_NONE\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"content-type\"] = 'application/json'\nrequest.body = \"{\\\"key\\\":\\\"string\\\",\\\"secret\\\":\\\"string\\\"}\"\n\nresponse = http.request(request)\nputs response.read_body"
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "v1_utils_check-api-credentials_createRequest": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "secret": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "secret"
        ],
        "example": {
          "key": "string",
          "secret": "string"
        }
      },
      "v1_utils_check-api-credentials_createResponse": {
        "type": "object",
        "properties": {
          "result": {
            "type": "boolean"
          },
          "key": {
            "type": "string"
          },
          "adminDomain": {
            "type": "string"
          }
        },
        "required": [
          "result",
          "key",
          "adminDomain"
        ],
        "example": {
          "result": false,
          "key": "string",
          "adminDomain": "string"
        }
      }
    }
  },
  "openapi": "3.0.2",
  "_id": {
    "buffer": {
      "0": 98,
      "1": 224,
      "2": 240,
      "3": 121,
      "4": 124,
      "5": 221,
      "6": 209,
      "7": 0,
      "8": 39,
      "9": 237,
      "10": 142,
      "11": 192
    }
  }
}
```