---
title: "Verify secret"
method: POST
path: "/secret/{secretId}/verify"
tags: ["Secret"]
---

# Verify secret

`POST /secret/{secretId}/verify`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/secret/{secretId}/verify`
- Auth: HTTP bearer

## Path parameters

- `secretId` string, required: The ID of the secret to be verified

## Request body

- object

## Response `200`

The secret was verified successfully

- object
  - `id` string, required: The ID of the verified secret
  - `status` 'unauthenticated' | 'authenticated', required: The status of the secret
  - `action` object: The action to take next
    - `type` 'authenticate', required: The type of action to take
    - `url` string, required: The URL to authenticate the secret

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)