어떤 agent에서도 몇 분 안에 Jade에게 맥락을 보내세요.

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

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

• Hermes나 자체 에이전트에서 가장 먼저 붙이기 좋은 엔드포인트입니다.
• 좋은 답변 하나씩 저장할 때 가장 단순합니다.

{
  "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를 한 요청 안에서 함께 다룰 수 있습니다.
• 이 경로는 item별 AI credits를 차감하고, credit 부족 시 항목별 failed 결과를 반환합니다.

curl https://thinkly.pluglab.ai/api/agent/upload \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: upload-001' \
  -F 'file=@notes.md'

{
  "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
}

• 현재 v1에서는 completed 상태의 lightweight job envelope을 반환합니다.
• clips를 먼저 page로 정리한 뒤 호출하는 것이 맞습니다.
• 드래프트 생성은 앱과 같은 AI credits를 사용합니다.

{
  "name": "4월 런치 플랜",
  "template": "goal_milestones",
  "icon": "🚀"
}

{
  "success": true,
  "data": {
    "id": "project_123",
    "name": "4월 런치 플랜",
    "template": "goal_milestones"
  },
  "error": null
}

• 단일 clip보다 긴 흐름을 운영할 때 적합합니다.
• 마일스톤형, 보드형 워크플로의 시작점으로 쓰기 좋습니다.
• 프로젝트 생성은 앱과 같은 활성 프로젝트 제한을 따릅니다.

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

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

• columnId를 생략하면 Thinkly가 해당 stage의 첫 workflow column을 자동으로 찾습니다.
• clip이나 page를 만든 직후 프로젝트 플로우에 이어 붙일 때 가장 자연스럽습니다.