DocumentationAPI ReferenceChangelog

Envocal API

API Reference Tools guide MCP server API Changelog

Endpoints

List credentials GETList secrets GET
Vault

List secrets

List credentials GET

The credentials in the tenant's vault that tools can authenticate with, by name. Use a credential's id as a tool's credentialId. Credentials are created and changed in the Studio (Vault); the API returns their name and type only, never their settings or secret values.

List knowledge bases of a tenant GET

Requires knowledge:read

GET
/v1/tenants/{tenantId}/vault/secrets

The secrets in the tenant's vault that tools can use, by name. A tool sends one in a header: the header has inputType: "secret" and the secret's id as its secretId. Secrets are created and changed in the Studio (Vault); the API returns their name only, never their value.

Required permission: vault:read

Authorization

Bearer
headerAuthorizationBearer <token>

Tenant API key (evk_…), created in Studio → Vault → API keys.

Path Parameters

tenantId*string

Tenant id, or current for the key's own tenant. Must be the key's tenant or one of its sub-tenants.

Response Body

The secrets, sorted by name.

  1. response
  1. response
  2. …
[index: integer]?

A secret in the tenant's vault that a tool can use. Its value is never returned.

Example Request
curl -X GET 'https://api.envocal.ai/v1/tenants/string/vault/secrets'
Example Response
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string"  }]
GET
/v1/tenants/{tenantId}/vault/secrets
Example Request
curl -X GET 'https://api.envocal.ai/v1/tenants/string/vault/secrets'
[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string"
  }
]