---
title: "Fetch a secret"
method: GET
path: "/secret/{secretId}/fetch"
tags: ["Secret"]
---

# Fetch a secret

`GET /secret/{secretId}/fetch`

## Request

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

## Path parameters

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

## Response `200`

The secret was retrieved successfully

- object: Blueprint properties
  - `alias` string, nullable: The unique alias for the instance
  - `name` string: The associated name
  - `description` string: The associated description
  - `meta` Meta: Meta data information
  - `id` string, required: The instance ID
  - `createdAt` number, required: The timestamp (ms) when the instance was created
  - `updatedAt` number, required: The timestamp (ms) when the instance was updated
  - `blueprintId` string, nullable: The ID of the blueprint
  - `kind` 'shared' | 'personal': The kind of the secret
  - `type` 'plain' | 'basic' | 'bearer' | 'jwt' | 'oauth' | 'template' | 'reference': The type of the secret
  - `config` object: The config of the secret (config.clientSecret is returned as '********' if configured, null otherwise)
  - `visibility` 'private' | 'protected' | 'public': The visibility of 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)