외부 맥락을 몇 분 만에 MyInc 워크스페이스로 보내요.

{
  "title": "저장할 답변",
  "text": "다시 쓸 가치가 있는 최종 요약입니다.",
  "tags": ["research", "launch"]
}

{
  "success": true,
  "data": {
    "id": "clip_123",
    "title": "저장할 답변",
    "text": "다시 쓸 가치가 있는 최종 요약입니다."
  },
  "error": null
}

• Hermes나 자체 에이전트에서 가장 먼저 붙이기 좋은 엔드포인트예요.
• 좋은 답변 하나씩 저장할 때 가장 단순해요.
• 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를 한 요청 안에서 함께 다룰 수 있어요(최대 50개).
• 이 경로는 item별 AI credits를 차감하고, credit 부족 시 항목별 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도 업로드에 그대로 적용돼요.
• 내부 웹 전용 upload가 아니라 Agent API facade예요.

{
  "mode": "custom",
  "prompt": "이 페이지를 발행 가능한 짧은 브리프로 바꿔주세요."
}

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

• 생성된 드래프트는 MyInc 안에서 회원님의 승인 대기 상태로 남고, 자동으로 발행되지 않아요.
• clips를 먼저 page로 정리한 뒤 호출해요(POST /api/agent/pages, GET /api/agent/pages/:id).
• GET /api/agent/jobs/:id 로 드래프트 상태를 조회하고, 생성은 앱과 같은 AI credits를 사용해요.

{
  "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를 만든 직후 프로젝트 플로우에 이어 붙일 때 가장 자연스러워요.