Minds API

Build AI personas trained on custom knowledge and embed them anywhere — via the Trigglio API.

Overview

Minds are AI-powered personas that can be trained on your content and deployed as conversational agents. The Minds API lets you:

Create Minds with custom names, personalities, and system prompts
Feed knowledge from documents, URLs, YouTube videos, and podcasts
Monitor processing status and receive webhook callbacks when done
Publish Minds to make them accessible via their public URL

Quick Start

1. Create an API Key

Go to Settings > API Keys in your dashboard and create a key with minds:read and minds:write scopes.

2. Create a Mind

cURL


curl -X POST "https://trigglio.com/api/v1/minds" \
  -H "Authorization: Bearer tr_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Expert",
    "headline": "Your AI product specialist",
    "systemPrompt": "You are a helpful product expert. Answer questions based on your knowledge base."
  }'

JavaScript


const res = await fetch('https://trigglio.com/api/v1/minds', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tr_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Product Expert',
    headline: 'Your AI product specialist',
    systemPrompt: 'You are a helpful product expert. Answer questions based on your knowledge base.'
  })
});
const { mind } = await res.json();
console.log('Created:', mind.id, mind.slug);

Python


import requests
 
res = requests.post(
    'https://trigglio.com/api/v1/minds',
    headers={'Authorization': 'Bearer tr_live_your_api_key'},
    json={
        'name': 'Product Expert',
        'headline': 'Your AI product specialist',
        'systemPrompt': 'You are a helpful product expert. Answer questions based on your knowledge base.'
    }
)
mind = res.json()['mind']
print(f"Created: {mind['id']} ({mind['slug']})")

3. Add Knowledge


curl -X POST "https://trigglio.com/api/v1/minds/{mindId}/knowledge" \
  -H "Authorization: Bearer tr_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Documentation",
    "type": "url",
    "url": "https://docs.example.com/product-guide",
    "callbackUrl": "https://your-server.com/webhooks/trigglio"
  }'

4. Wait for Processing

Knowledge sources are processed asynchronously. You can either:

Poll the source status endpoint: GET /api/v1/minds/{mindId}/knowledge/{sourceId}
Receive a webhook at your callbackUrl when processing completes

5. Publish


curl -X POST "https://trigglio.com/api/v1/minds/{mindId}/publish" \
  -H "Authorization: Bearer tr_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "isPublished": true }'

Your Mind is now live at https://trigglio.com/m/{slug}.

Required Scopes

Scope	Description
`minds:read`	List and view Minds
`minds:write`	Create, update, delete, publish Minds, and manage knowledge sources

Knowledge Source Types

Type	Description	Input
`url`	Web page content	`url` field
`document`	PDF, DOCX, TXT, MD files	Upload file first, then use `fileUrl`
`youtube`	YouTube video transcripts	`youtubeUrl` field
`podcast`	Audio file transcriptions	Upload file first, then use `fileUrl`

Processing Lifecycle


pending → processing → ready
                    ↘ failed

pending → processing → transcribing → ready
                                   ↘ failed

Sources that need audio transcription (YouTube videos without captions, podcasts) go through an additional transcribing step.

Webhook Callbacks

When you provide a callbackUrl on a knowledge source, Trigglio will send a POST request when processing finishes:


{
  "event": "knowledge.processed",
  "sourceId": "src_abc123",
  "mindId": "mind_xyz789",
  "status": "ready",
  "chunkCount": 42,
  "error": null,
  "timestamp": "2024-06-15T10:30:00.000Z"
}

The request includes an X-Trigglio-Signature header (HMAC-SHA256) for verification.

Next Steps

Minds API Reference — Full endpoint documentation
Knowledge Sources — Deep dive on each source type
Code Examples — Complete workflow examples