createSecret

Store a secret securely in the Vault. Use this to save API keys, credentials, or sensitive data. Returns the ID of the created secret but NOT the secret value. This tool is write-only, you cannot read the secret back using this tool.

API Endpoint

POST /api/agents/tools/createSecret

Request Body

• site_id (string, required): The site identifier.
• name (string, required): A recognizable name for the secret.
• description (string, required): Description of the secret.
• secret (string, required): The sensitive secret value.

Response

Returns success status and data.

{
  "success": true,
  "message": "Secret created successfully",
  "data": {
    "id": "uuid-of-created-secret",
    "name": "STRIPE_API_KEY",
    "description": "API Key for Stripe payments",
    "created_at": "2026-03-25T00:00:00Z"
  }
}