Bring externen Kontext in Minuten in deinen MyInc-Workspace.

{
  "title": "Gespeicherte Antwort",
  "text": "Das ist die finale Zusammenfassung, die es wert ist, bleibt.",
  "tags": ["research", "launch"]
}

{
  "success": true,
  "data": {
    "id": "clip_123",
    "title": "Gespeicherte Antwort",
    "text": "Das ist die finale Zusammenfassung, die es wert ist, bleibt."
  },
  "error": null
}

• Guter erster Endpoint für Hermes oder deinen eigenen Agent.
• Ideal für eine finale Antwort pro Aufruf.
• GET /api/agent/clips listet Clips mit clips:read.

{
  "items": [
    { "type": "url", "url": "https://example.com/article" },
    { "type": "markdown", "title": "Notizen", "text": "# Kernpunkte\n- Eins\n- Zwei" }
  ]
}

{
  "success": true,
  "data": {
    "captureBatchId": "batch_123",
    "created": [
      { "id": "clip_1", "title": "https://example.com/article", "url": "https://example.com/article" },
      { "id": "clip_2", "title": "Notizen", "url": null }
    ],
    "failed": []
  },
  "error": null
}

• Bester Startpunkt, wenn ein Agent mehrere Elemente auf einmal sendet.
• text, url und markdown sind in einer Anfrage möglich (bis zu 50 Elemente).
• Diese Route berechnet KI-Credits pro Element und liefert elementweise Fehler, wenn die Credits aufgebraucht sind.

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

{
  "success": true,
  "data": {
    "id": "clip_upload_123",
    "title": "notes.md"
  },
  "error": null
}

• Nutze dies, wenn dein Agent echte Dateien statt JSON sendet.
• Scoped Keys und Idempotenz funktionieren auch bei Uploads.
• Das ist die öffentliche Agent-Fassade über dem MyInc-Datei-Upload, nicht die interne Web-Route.

{
  "mode": "custom",
  "prompt": "Mach aus dieser page ein kurzes, veröffentlichbares Briefing."
}

{
  "success": true,
  "data": {
    "jobId": "draft_123",
    "type": "page_generation",
    "status": "completed",
    "result": {
      "draftId": "draft_123"
    }
  },
  "error": null
}

• Der generierte draft bleibt in MyInc zur Freigabe bereit; nichts wird automatisch veröffentlicht.
• Nutze dies, nachdem Clips in einer page organisiert sind (POST /api/agent/pages, GET /api/agent/pages/:id).
• Frage GET /api/agent/jobs/:id für den draft-Status ab; die Generierung verbraucht dieselben KI-Credits wie der In-App-Flow.

{
  "name": "April-Launch-Plan",
  "template": "goal_milestones",
  "icon": "🚀"
}

{
  "success": true,
  "data": {
    "id": "project_123",
    "name": "April-Launch-Plan",
    "template": "goal_milestones"
  },
  "error": null
}

• Nutze dies, wenn der Agent einen dauerhaften Workspace braucht, nicht nur einen Clip.
• Templates: goal_milestones oder pipeline_board.
• Die project-Erstellung folgt denselben Limits aktiver projects wie die App.

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

{
  "success": true,
  "data": {
    "id": "project_item_123",
    "stage": "clip",
    "referenceId": "clip_123"
  },
  "error": null
}

• Wird columnId weggelassen, ermittelt MyInc die erste Workflow-Spalte für diese Stage.
• Nutze dies direkt nach dem Erstellen eines clips oder einer page, wenn der Agent einen project-Flow aufbaut.