Skip to content
Kindo Kindo Docs

First API Call

This quickstart walks you through making your first API call to Kindo. By the end, you will have sent a request to the Inference API and received a model response.

Prerequisites

  • A Kindo account (SaaS or self-hosted)
  • An API key (see below)
  • curl or any HTTP client

Get Your API Key

  1. Sign in to the Kindo Terminal.
  2. Click the gear icon (top right) to open Settings.
  3. Navigate to API.
  4. Copy your API key. Keep it secure — treat it like a password.

Send a Chat Request

The Kindo Inference API is OpenAI-compatible. Send a chat completion request:

Terminal window
curl -X POST https://api.kindo.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [
      {
        "role": "user",
        "content": "What are the top 3 cloud security best practices?"
      }
    ]
  }'

Replace YOUR_API_KEY with the key from your Settings page. For self-hosted installations, replace api.kindo.ai with your API endpoint.

Response Format

The API returns a standard chat completion response:

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here are the top 3 cloud security best practices..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 200,
    "total_tokens": 215
  }
}

Run an Agent via API

You can also trigger agents programmatically:

Terminal window
curl -X POST https://api.kindo.ai/v1/agents/YOUR_AGENT_ID/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "input": "Run the daily security scan"
  }'

Available Models

View the models available to your organization:

Terminal window
curl https://api.kindo.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Tips

  • Rate limits — API requests are subject to your organization’s rate limits and credit balance.
  • DLP applies — The same Data Loss Prevention filters that protect chat also apply to API requests.
  • Audit logging — All API calls are logged in your organization’s audit trail.

Next Steps