Minds API Reference

Complete endpoint reference for the Minds API.

Base URL


https://trigglio.com/api/v1

List Minds


GET /api/v1/minds

Scope: minds:read

Query parameters:

Parameter	Type	Default	Description
`page`	integer	1	Page number
`limit`	integer	20	Results per page (max 100)

cURL


curl -X GET "https://trigglio.com/api/v1/minds?page=1&limit=10" \
  -H "Authorization: Bearer tr_live_your_api_key"

JavaScript


const res = await fetch('https://trigglio.com/api/v1/minds?page=1&limit=10', {
  headers: { 'Authorization': 'Bearer tr_live_your_api_key' }
});
const { minds, pagination, usage } = await res.json();

Python


res = requests.get(
    'https://trigglio.com/api/v1/minds',
    headers={'Authorization': 'Bearer tr_live_your_api_key'},
    params={'page': 1, 'limit': 10}
)
data = res.json()

Response:


{
  "status": "success",
  "minds": [
    {
      "id": "cm_abc123",
      "name": "Product Expert",
      "slug": "product-expert-a1b2c3",
      "headline": "Your AI product specialist",
      "bio": null,
      "avatarUrl": null,
      "isPublished": true,
      "createdAt": "2024-06-15T10:30:00Z",
      "updatedAt": "2024-06-15T10:30:00Z",
      "knowledgeSourceCount": 5,
      "conversationCount": 142
    }
  ],
  "usage": {
    "mindsUsed": 3,
    "mindsLimit": 10,
    "sourcesUsed": 15,
    "sourcesLimit": 50
  },
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 3,
    "totalPages": 1
  }
}

Create Mind


POST /api/v1/minds

Scope: minds:write

Body parameters:

Field	Type	Required	Description
`name`	string	Yes	Mind name (max 100 chars)
`slug`	string	No	URL slug (auto-generated if omitted)
`headline`	string	No	Short description
`bio`	string	No	Longer biography
`avatarUrl`	string	No	Avatar image URL
`systemPrompt`	string	No	Custom system prompt
`welcomeMessage`	string	No	First message shown to visitors
`suggestedQuestions`	string[]	No	Up to 4 suggested questions
`expertiseAreas`	string[]	No	Up to 10 expertise tags

Response: 201 Created with the created mind object.

Get Mind


GET /api/v1/minds/{mindId}

Scope: minds:read

Returns detailed mind information including source statistics.

Response:


{
  "status": "success",
  "mind": {
    "id": "cm_abc123",
    "name": "Product Expert",
    "slug": "product-expert-a1b2c3",
    "knowledgeSourceCount": 5,
    "conversationCount": 142,
    "recentConversationCount": 28,
    "sourceLimit": 20,
    "sourceStats": {
      "total": 5,
      "ready": 4,
      "pending": 0,
      "processing": 1,
      "failed": 0
    }
  }
}

Update Mind


PATCH /api/v1/minds/{mindId}

Scope: minds:write

Send only the fields you want to update. All fields from Create Mind are accepted, plus:

Field	Type	Description
`isPublished`	boolean	Publish or unpublish the Mind
`showSources`	boolean	Show source citations in responses
`collectEmailBeforeChat`	boolean	Require email before chatting
`temperature`	number	AI creativity (0-2, default 0.7)
`theme`	object\|null	`{ primaryColor, backgroundColor, fontFamily, mode }`
`socialLinks`	object\|null	`{ twitter, linkedin, youtube, website, instagram }`
`voiceEnabled`	boolean	Enable voice responses
`voiceId`	string	One of: alloy, echo, fable, onyx, nova, shimmer
`voiceSpeed`	number	Voice speed (0.25-4.0)

Delete Mind


DELETE /api/v1/minds/{mindId}

Scope: minds:write

Permanently deletes the Mind and all its knowledge sources, conversations, and uploaded files.

Response:


{
  "status": "success",
  "deleted": true,
  "id": "cm_abc123"
}

Publish / Unpublish


POST /api/v1/minds/{mindId}/publish

Scope: minds:write

Body:


{ "isPublished": true }

Response:


{
  "status": "success",
  "mind": {
    "id": "cm_abc123",
    "slug": "product-expert-a1b2c3",
    "isPublished": true,
    "publicUrl": "https://trigglio.com/m/product-expert-a1b2c3"
  }
}

Publishing a Mind with no ready knowledge sources will return a warning field in the response.

List Knowledge Sources


GET /api/v1/minds/{mindId}/knowledge

Scope: minds:read

Query parameters:

Parameter	Type	Default	Description
`page`	integer	1	Page number
`limit`	integer	20	Results per page (max 100)
`status`	string	—	Filter by status: pending, processing, transcribing, ready, failed

Add Knowledge Source


POST /api/v1/minds/{mindId}/knowledge

Scope: minds:write

See Knowledge Sources for detailed type-specific documentation.

Get Knowledge Source


GET /api/v1/minds/{mindId}/knowledge/{sourceId}

Scope: minds:read

Returns full source details with processing status. Includes Retry-After: 5 header when source is still processing.

Delete Knowledge Source


DELETE /api/v1/minds/{mindId}/knowledge/{sourceId}

Scope: minds:write

Reprocess Knowledge Source


POST /api/v1/minds/{mindId}/knowledge/{sourceId}/reprocess

Scope: minds:write

Re-triggers processing for sources in pending, ready, or failed status. Cannot reprocess while status is processing or transcribing.

Upload File


POST /api/v1/minds/{mindId}/knowledge/upload

Scope: minds:write

Content-Type: multipart/form-data

Upload a file to use as a knowledge source. Returns the CDN URL to use when creating a document or podcast source.

File limits:

Category	Formats	Max Size
Documents	PDF, DOCX, TXT, MD	50 MB
Audio	MP3, WAV, M4A, OGG	500 MB

cURL


curl -X POST "https://trigglio.com/api/v1/minds/{mindId}/knowledge/upload" \
  -H "Authorization: Bearer tr_live_your_api_key" \
  -F "file=@/path/to/document.pdf"

Response:


{
  "status": "success",
  "fileUrl": "https://cdn.trigglio.com/minds/cm_abc123/knowledge/1718445000-a1b2c3.pdf",
  "fileName": "document.pdf",
  "mimeType": "application/pdf",
  "fileSize": 1048576,
  "category": "document"
}