Agent API v1

Lleva contexto externo a tu espacio MyInc en minutos.

Envía notas, enlaces, markdown y archivos a tu espacio de trabajo de MyInc con una sola API key. Usa la misma API para convertir ese contexto en pages y drafts, que siempre esperan tu aprobación antes de publicarse.

First request
curl https://myinc.app/api/agent/clips \
  -X POST \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: clip-001' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Insight semanal",
    "text": "Guarda la respuesta final de la investigación de hoy."
  }'
Clips
POST /api/agent/clips
Ingest
POST /api/agent/ingest
Upload
POST /api/agent/upload
Projects
POST /api/agent/projects

Lleva contexto externo a tu espacio de trabajo

Guarda una nota, un enlace o una respuesta

Envía un elemento a la vez a tu espacio MyInc como un clip que tu equipo de IA puede reutilizar.

Haz ingest de enlaces, texto y markdown por lotes

Agrupa elementos relacionados en una sola captura para que tu espacio los mantenga juntos.

Crea pages y genera drafts

Primero organiza el contexto en una page y luego pide a MyInc que genere un draft, que queda a la espera de tu aprobación.

Crea projects y añade elementos

Abre un project desde tu agente y coloca clips, pages y drafts en las etapas del project a medida que avanza el trabajo.

Quickstart

1

Inicia sesión en MyInc y crea una API key con scope en Settings → API keys.

2

Envía la key como auth Bearer en cada solicitud y añade un Idempotency-Key en las de escritura.

3

Empieza con un clip o un lote de ingest y luego expándete a pages, generación de drafts, subidas y projects.

Autenticación

La Agent API v1 de MyInc usa API keys personales. Crea keys con scope para integraciones específicas en Settings → API keys y guárdalas en el servidor como tokens Bearer.

curl https://myinc.app/api/agent/clips \
  -X POST \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: clip-001' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Insight semanal",
    "text": "Guarda la respuesta final de la investigación de hoy."
  }'
  • Las API keys con scope son compatibles con clips, ingest, uploads, pages, generation y projects.
  • Scopes recomendados: clips:write, ingest:write, upload:write, pages:read, pages:generate, projects:write.
  • Las keys se crean y revocan en Settings → API keys.

Créditos y límites

Las solicitudes a la Agent API usan los mismos límites de plan que el producto. Los créditos se aplican a las acciones con IA, no a una cuota separada solo para agentes.

  • POST /api/agent/ingest usa créditos de IA por elemento: text 1, markdown 1, url 2.
  • POST /api/agent/pages/:id/generate usa créditos de IA: custom 6, template set 15.
  • La creación de projects sigue el límite de projects activos de tu plan.

Escrituras idempotentes

Los endpoints de escritura admiten Idempotency-Key. Reenviar la misma solicitud con la misma key devuelve el resultado guardado. Reutilizar la misma key con otro body devuelve 409.

curl https://myinc.app/api/agent/projects \
  -X POST \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: project-2026-04-launch' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Plan de lanzamiento de abril",
    "template": "goal_milestones"
  }'

Endpoints principales

POST/api/agent/clips

Crear un clip

Úsalo para una sola nota, enlace o respuesta guardada.

{
  "title": "Respuesta guardada",
  "text": "Este es el resumen final que vale la pena conservar.",
  "tags": ["research", "launch"]
}
POST/api/agent/ingest

Ingest por lotes

Envía texto, URLs y markdown juntos y mantenlos agrupados en una sola captura.

{
  "items": [
    { "type": "url", "url": "https://example.com/article" },
    { "type": "markdown", "title": "Notas", "text": "# Puntos clave\n- Uno\n- Dos" }
  ]
}
POST/api/agent/upload

Subir un archivo

Envía subidas multipart por la misma superficie de la Agent API cuando tu agente necesita adjuntar archivos.

curl https://myinc.app/api/agent/upload \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: upload-001' \
  -F '[email protected]'
POST/api/agent/pages/:id/generate

Generar un draft desde una page

Usa la generación de pages cuando tus clips ya están organizados en una page.

{
  "mode": "custom",
  "prompt": "Convierte esta page en un brief corto y publicable."
}
POST/api/agent/projects

Crear un project

Abre un nuevo project de MyInc desde tu flujo de agente con nombre, plantilla y estado.

{
  "name": "Plan de lanzamiento de abril",
  "template": "goal_milestones",
  "icon": "🚀"
}
POST/api/agent/projects/:id/items

Añadir un elemento a una etapa del project

Coloca un clip, page, draft o elemento publicado en una etapa del project de MyInc desde tu flujo de agente.

{
  "stage": "clip",
  "referenceId": "clip_123"
}

Forma común de respuesta

La Agent API v1 devuelve un envelope normalizado para que tu integración maneje el éxito y el error de forma coherente.

{
  "success": true,
  "data": {
    "id": "clip_123",
    "title": "Respuesta guardada"
  },
  "error": null
}

Hecha para Hermes y tus propios agentes

Conecta Hermes o cualquier agente que construyas a tu espacio MyInc. Empieza con clips e ingest y añade pages, generación y projects a medida que tu equipo de IA asume más trabajo.

Cómo llega el contexto externo a tu espacio de trabajo

Primero captura con clips e ingest

Apunta tu agente a clips e ingest para enviar notas, enlaces y markdown a tu espacio MyInc sobre la marcha.

Ver descripción del producto

Luego construye pages y projects

Una vez que el contexto está en tu espacio, genera pages y drafts y organiza el trabajo en projects, todo a la espera de tu aprobación.

Ver descripción del producto

Ejemplos de referencia por endpoint

Abre cada endpoint para ver un body de solicitud, un ejemplo de respuesta y notas de integración.

POST/api/agent/clipsCrear un clip
Request body
{
  "title": "Respuesta guardada",
  "text": "Este es el resumen final que vale la pena conservar.",
  "tags": ["research", "launch"]
}
Response
{
  "success": true,
  "data": {
    "id": "clip_123",
    "title": "Respuesta guardada",
    "text": "Este es el resumen final que vale la pena conservar."
  },
  "error": null
}
Notes
  • Buen primer endpoint para Hermes o tu propio agente.
  • Funciona bien para una respuesta final a la vez.
  • GET /api/agent/clips lista clips con clips:read.
POST/api/agent/ingestIngest por lotes
Request body
{
  "items": [
    { "type": "url", "url": "https://example.com/article" },
    { "type": "markdown", "title": "Notas", "text": "# Puntos clave\n- Uno\n- Dos" }
  ]
}
Response
{
  "success": true,
  "data": {
    "captureBatchId": "batch_123",
    "created": [
      { "id": "clip_1", "title": "https://example.com/article", "url": "https://example.com/article" },
      { "id": "clip_2", "title": "Notas", "url": null }
    ],
    "failed": []
  },
  "error": null
}
Notes
  • Mejor punto de partida cuando un agente envía varios elementos a la vez.
  • Admite text, url y markdown en una sola solicitud (hasta 50 elementos).
  • Esta ruta cobra créditos de IA por elemento y devuelve fallos por elemento cuando se agotan.
POST/api/agent/uploadSubir un archivo
Request body
curl https://myinc.app/api/agent/upload \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: upload-001' \
  -F '[email protected]'
Response
{
  "success": true,
  "data": {
    "id": "clip_upload_123",
    "title": "notes.md"
  },
  "error": null
}
Notes
  • Úsalo cuando tu agente envía archivos reales en lugar de JSON.
  • Las keys con scope y la idempotencia también funcionan en subidas.
  • Es la fachada pública de agente sobre la subida de archivos de MyInc, no la ruta web interna.
POST/api/agent/pages/:id/generateGenerar un draft desde una page
Request body
{
  "mode": "custom",
  "prompt": "Convierte esta page en un brief corto y publicable."
}
Response
{
  "success": true,
  "data": {
    "jobId": "draft_123",
    "type": "page_generation",
    "status": "completed",
    "result": {
      "draftId": "draft_123"
    }
  },
  "error": null
}
Notes
  • El draft generado queda a la espera de tu aprobación dentro de MyInc; nada se publica solo.
  • Úsalo después de organizar los clips en una page (POST /api/agent/pages, GET /api/agent/pages/:id).
  • Consulta GET /api/agent/jobs/:id para el estado del draft; la generación consume los mismos créditos de IA que el flujo de la app.
POST/api/agent/projectsCrear un project
Request body
{
  "name": "Plan de lanzamiento de abril",
  "template": "goal_milestones",
  "icon": "🚀"
}
Response
{
  "success": true,
  "data": {
    "id": "project_123",
    "name": "Plan de lanzamiento de abril",
    "template": "goal_milestones"
  },
  "error": null
}
Notes
  • Úsalo cuando el agente necesita un espacio duradero, no solo un clip.
  • Plantillas: goal_milestones o pipeline_board.
  • La creación de projects sigue los mismos límites de projects activos del plan.
POST/api/agent/projects/:id/itemsAñadir un elemento a una etapa del project
Request body
{
  "stage": "clip",
  "referenceId": "clip_123"
}
Response
{
  "success": true,
  "data": {
    "id": "project_item_123",
    "stage": "clip",
    "referenceId": "clip_123"
  },
  "error": null
}
Notes
  • Si se omite columnId, MyInc resuelve la primera columna del flujo para esa etapa.
  • Úsalo justo después de crear un clip o una page cuando el agente arma un flujo de project.

Alcance actual de v1

  • Agent API privada para integraciones tempranas, todavía no una plataforma pública totalmente versionada.
  • Las API keys con scope, las keys de idempotencia y la fachada de subida ya están incluidas en v1.
  • Los jobs de generación usan por ahora un wrapper ligero sobre la generación de drafts de MyInc.

Empieza con una solicitud útil y deja que tu equipo de IA siga.

La mejor primera integración es simple: guarda una respuesta útil, un enlace o una nota en markdown en tu espacio de trabajo. Cuando funcione, conviértela en pages y drafts que tu equipo de IA prepara para tu aprobación.

Ver primera solicitudVer descripción del producto