スクリプトやエージェントからドキュメントを生成
REST API、CLI、そしてClaude CodeやCursorなどのエージェント向けのエージェント用スキルが、アプリと同じ操作を呼び出します。動画からのドキュメント生成、記事の編集、公開ができ、Solo / Small Teamプラン以上で利用できます。
1つのドキュメントAPI、8つのエンドポイントグループ
記事、フォルダ、テンプレート、動画、生成、プロジェクト設定、公開、エクスポートが1つのOpenAPI仕様にまとめられており、ブラウザでもコードジェネレーターでも読める同じリファレンスです。翻訳、バージョンの復元、再生成はそれらのグループの中にあります。
生成して、ジョブを確認する
ポーリングの代わりに署名付きコールバックを受け取る
4つのスコープ、エンドポイントごとに適用
v2のすべてのリクエストは、実行前にキーのスコープを確認します。generateはジョブを開始し、writeはコンテンツの作成、編集、移動を行い、publishは公開または再公開を行い、readはそれ以外をすべてカバーします。キーは発行されたプロジェクトに対してのみ動きます。制限付きキーの発行はまだ実装されていないため、現在はどのキーも4つのスコープをすべて持ちます。
| スコープ | 許可される操作 | 例 |
|---|---|---|
read | 記事、フォルダ、テンプレート、動画、エクスポート、ジョブ状態の読み取り | GET /articlesGET /generate/{jobId} |
write | コンテンツの作成、移動、複製、復元、そして動画のアップロード | POST /articles/emptyPATCH /folders/{id}/move |
generate | 生成、再生成、翻訳の開始、そしてリンクからの動画のインポート | POST /generatePOST /videos/import |
publish | プロジェクトの公開と再公開 | POST /publishPOST /publish/republish |
ターミナルから実行する、またはエージェントに任せる
CLIは同じAPIをラップし、エージェント用スキルはそのCLIをラップするので、人、スクリプト、Claude CodeやCursorのようなエージェントが同じコマンドに届きます。スクリプトが読める出力には--json、ジョブが終わるまで待つには--waitを付けます。
$npm install -g @hintoai/cli
CLIをインストール$hinto articles list
プロジェクトのすべての記事を一覧表示$npx skills add hintoai/hinto-cli
エージェント用スキルをインストールWebhook:4つのイベント、1つのURL、独自のヘッダー
プロジェクトは公開、再公開、非公開、アーカイブのときにWebhookを発火し、認証用に追加したヘッダーを運びます。各呼び出しはイベント名、プロジェクトと公開のID、タイムスタンプ、プロジェクトの名前とURLスラッグを送ります。何が起きてどこで見られるかの通知であり、コンテンツそのものではありません。
project.publishプロジェクトが初めて公開されたときproject.republishプロジェクトが変更とともに再公開されたときproject.unpublishプロジェクトが非公開になったときproject.archiveプロジェクトがアーカイブされたとき
{
"event": "project.republish",
"projectId": "<project id>",
"publicationId": "<publication id>",
"timestamp": "2026-09-15T10:24:00.000Z",
"data": {
"projectName": "Acme Help Center",
"urlSlug": "acme"
}
}追加した独自のヘッダーを付けてPOSTで送信されます。Hintoは最大3回試行し、各試行で最大30秒待ち、4xxの応答には再試行しません。仕組みを見るすでに使っているツールにつながります
Webhook、サポートの受信箱、ウェブサイトビルダーが、どれも同じプロジェクトから読み取れます。
自社システム向けのWebhook
Webhookを自社のエンドポイントに向けて、公開、再公開、非公開、アーカイブが起きたその場で反応できます。
Intercom Finがそこから回答します
プロジェクトのコンテンツをIntercomに同期すると、IntercomのサポートエージェントであるFinが、Hintoが生成した内容から回答します。
Framerがサイトに取り込みます
Framerのプラグインが記事とフォルダをFramer CMSに取り込むので、Framerで構築してホストするサイトに使えます。
他の機能
Hinto API、CLI、エージェント用スキルに関するご質問
不要です。各リクエストはX-API-Keyヘッダーを運び、キーは1つのプロジェクトの設定で作成します。
より良い
ナレッジベースを、より速く構築しませんか?
無料で始めて、数分で最初の記事を作成しましょう