DocumentationAPI ReferenceChangelog

Envocal API

API Reference Tools guide MCP server API Changelog

Endpoints

List credentials GETList secrets GET
Vault

List credentials

Create a tool from a template POST

Copies a tool template into a new private tool of the tenant: the request with its static values, the variables, the response mapping, phases, channels and the credential type. The credential and the vault secrets are not copied: set credentialId, and secretId on each header that takes a secret, on the new tool with PUT /v1/tenants/{tenantId}/tools/{id}.

List secrets GET

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.

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

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.

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 credentials, sorted by name.

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

A credential in the tenant's vault that a tool can authenticate with. Its settings and secret values are never returned.

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