外部の文脈を数分で MyInc ワークスペースへ。

{
  "title": "保存する回答",
  "text": "再利用する価値のある最終サマリーです。",
  "tags": ["research", "launch"]
}

{
  "success": true,
  "data": {
    "id": "clip_123",
    "title": "保存する回答",
    "text": "再利用する価値のある最終サマリーです。"
  },
  "error": null
}

• Hermes や自作エージェントから最初に繋ぐのに良いエンドポイントです。
• 良い回答を1つずつ保存するのに最もシンプルです。
• GET /api/agent/clips は clips:read で一覧を取得します。

{
  "items": [
    { "type": "url", "url": "https://example.com/article" },
    { "type": "markdown", "title": "メモ", "text": "# 要点\n- 一\n- 二" }
  ]
}

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

• エージェントが複数項目を一度に送るときに最適です。
• text・url・markdown を1リクエストで扱えます（最大50件）。
• この経路は項目ごとに AI クレジットを消費し、不足時は項目単位の failed を返します。

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
}

• 実ファイルを送る必要があるときにこの経路を使います。
• scoped key と idempotency もアップロードに適用されます。
• 内部の web 専用 upload ではなく、Agent API のファサードです。

{
  "mode": "custom",
  "prompt": "このページを公開可能な短いブリーフにしてください。"
}

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

• 生成されたドラフトは MyInc 内であなたの承認待ちのまま残り、自動公開されません。
• clip を先に page へ整理してから呼び出します（POST /api/agent/pages、GET /api/agent/pages/:id）。
• GET /api/agent/jobs/:id でドラフト状態を確認でき、生成はアプリと同じ AI クレジットを使用します。

{
  "name": "4月ローンチ計画",
  "template": "goal_milestones",
  "icon": "🚀"
}

{
  "success": true,
  "data": {
    "id": "project_123",
    "name": "4月ローンチ計画",
    "template": "goal_milestones"
  },
  "error": null
}

• 単一の clip より長い流れを運用するときに適しています。
• テンプレート: goal_milestones または pipeline_board。
• プロジェクト作成はアプリと同じ有効プロジェクト数の上限に従います。

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

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

• columnId を省略すると、MyInc がその stage の最初の workflow column を自動的に解決します。
• clip や page を作った直後にプロジェクトの流れへ繋ぐのが自然です。