Documentation

Authentication

Blutec Echo is a REST API. Create an API key in Dashboard → API Access and send it as a Bearer token on every request. No packages or SDK install required — use cURL or any HTTP client.

Headers and base URL

Request format
# Base URL for all API requests
https://bkbharatai.blutec.ai=https://bkecho.blutec.ai

# Required on every request
Authorization: Bearer be_your_api_key_here
Content-Type: application/json

Verify your key

List agents to confirm authentication works. An empty list is fine — you just need a 200 response.

cURL
curl -X GET "https://bkbharatai.blutec.ai/api/agents" \
  -H "Authorization: Bearer be_your_api_key_here" \
  -H "Content-Type: application/json"

Common errors

HTTP status codes
# 401 — missing or invalid API key
# 403 — key valid but not allowed for this resource
# 404 — agent, call, or resource not found
# 422 — validation error (check the response body for field details)

Related