Visión general de la API

Te damos la bienvenida a la documentación de la API de Minds. Nuestra API te permite crear y gestionar minds con IA de forma programática, subir knowledge e interactuar con ellos.

Comenzar

La API de Minds está organizada según los principios REST. Nuestra API tiene URLs predecibles orientadas a recursos, acepta bodies de solicitud codificados en JSON, devuelve respuestas codificadas en JSON y utiliza códigos de respuesta HTTP, autenticación y verbos estándar.

Base URL

Producción: https://getminds.ai/api/v1 o https://api.getminds.ai/v1

Desarrollo local: http://localhost:3000/api/v1

Ambas URLs base de producción son totalmente equivalentes. Se recomienda el subdominio api.getminds.ai para URLs de integración más limpias.

Autenticación

Todos los endpoints de la API requieren autenticación vía API key. Puedes generar y gestionar tus API keys en Settings → API Keys.

Incluye tu API key en el header Authorization:

Authorization: Bearer minds_your_api_key_here

Especificación OpenAPI

Se publica una especificación OpenAPI 3.1.0 legible por máquina en /_openapi.json. Usa la especificación para generar clientes tipados (TypeScript, Python, etc.) o para pegarla en un LLM y obtener código de integración de una sola vez. Consulta OpenAPI para ver ejemplos.

Content Type

Todas las solicitudes que envían datos deben incluir el header Content-Type:

Content-Type: application/json

Para subidas de archivos, usa:

Content-Type: multipart/form-data

Endpoints disponibles

Sparks

Crea y gestiona minds con IA (agentes) con configuraciones personalizadas.

• GET /api/v1/sparks - Lista todos los sparks
• GET /api/v1/sparks/{sparkId} - Obtiene los detalles de un spark
• POST /api/v1/sparks - Crea un nuevo spark
• PUT /api/v1/sparks/{sparkId} - Actualiza un spark
• DELETE /api/v1/sparks/{sparkId} - Elimina un spark
• POST /api/v1/sparks/{sparkId}/regenerate-prompt - Regenera el system prompt a partir del knowledge

Knowledge

Gestiona el knowledge de tus minds.

• GET /api/v1/sparks/{sparkId}/knowledge - Lista los elementos de knowledge
• POST /api/v1/sparks/{sparkId}/knowledge - Añade knowledge (links, archivos o búsqueda por palabras clave)
• PUT /api/v1/sparks/{sparkId}/knowledge/{itemId} - Actualiza un elemento de knowledge
• DELETE /api/v1/sparks/{sparkId}/knowledge/{itemId} - Elimina un elemento de knowledge
• POST /api/v1/sparks/{sparkId}/knowledge/enrich - Enriquece mediante búsqueda por palabras clave (alias de conveniencia)
• GET /api/v1/sparks/{sparkId}/knowledge/patterns - Obtiene los patrones de knowledge por framework

Chat

Interactúa con tus minds mediante chat completions.

• POST /api/v1/sparks/{sparkId}/completion - Envía mensajes y obtén respuestas

Panels

Crea y gestiona paneles de IA para encuestar grupos de minds.

• GET /api/v1/panels - Lista todos los paneles
• POST /api/v1/panels - Crea un nuevo panel
• GET /api/v1/panels/{panelId} - Obtiene los detalles del panel con el historial de mensajes
• POST /api/v1/panels/{panelId}/ask - Hace una pregunta a todos los minds del panel (SSE stream)
• POST /api/v1/panels/{panelId}/export - Exporta los resultados del panel como informe
• GET /api/v1/panels/{panelId}/export-status - Comprueba el estado del job de exportación
• GET /api/v1/panels/{panelId}/export-download - Descarga el PDF exportado

User

Endpoints relacionados con el usuario.

• GET /api/v1/auth/me - Obtiene el usuario autenticado actual
• GET /api/v1/user/shareable-sparks - Lista los minds disponibles para compartir

API Keys

Gestiona tus API keys para autenticación.

• GET /api/v1/api-keys - Lista tus API keys
• POST /api/v1/api-keys - Crea una nueva API key
• DELETE /api/v1/api-keys/{keyId} - Elimina una API key

Ejemplo rápido

Aquí tienes un ejemplo rápido de cómo crear un mind y chatear con él:

# 1. Create a mind (keywords mode)
curl -X POST "https://getminds.ai/api/v1/sparks" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Expert",
    "description": "Expert in digital marketing strategies",
    "mode": "keywords",
    "type": "expert",
    "discipline": "Marketing",
    "keywords": ["SEO", "content marketing", "social media", "analytics"]
  }'

# Response: { "data": { "id": "spark-id", ... }, "processing": { "queued": true, ... } }

# 2. Create a mind from social profile (clone mode)
curl -X POST "https://getminds.ai/api/v1/sparks" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Influencer Clone",
    "description": "AI trained on influencer social presence",
    "mode": "clone",
    "type": "creative",
    "discipline": "Social Media Marketing",
    "personaContext": "https://twitter.com/username"
  }'

# 3. Chat with the mind
curl -X POST "https://getminds.ai/api/v1/sparks/spark-id/completion" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "What are the top social media trends for 2025?"
      }
    ]
  }'

Siguientes pasos

• Aprende sobre Autenticación
• Explora los endpoints de Sparks
• Lee sobre Gestión de knowledge
• Comprende Chat completions
• Crea Paneles para encuestas multi-mind
• Revisa Latencia y rendimiento
• Conéctate vía Integración MCP
• Revisa Errores y límites

Límites del plan

El uso de la API está sujeto a tu plan de suscripción:

Ver planes

¿Necesitas ayuda?

Si tienes preguntas o necesitas soporte con la API:

• Consulta nuestra Guía
• Contáctanos a través del formulario de feedback
• Únete a las conversaciones de la comunidad