openapi-mcp-server

Letta API 用のモデルコンテキストプロトコル (MCP) サーバー。

説明

このサーバーは、API へのモデルコンテキストプロトコル (MCP) インターフェイスを提供します。

Related MCP server: Zero Trust Access AI Agent - MCP Server

インストール

依存関係をインストールします:

npm install

.env.exampleに基づいて.envファイルを作成します。

cp .env.example .env

.envファイルを編集して、API 構成と承認の詳細を追加します。

構成

.envファイルでは次の環境変数を設定できます。

API_BASE_URL : APIのベースURL（必須）
SERVER_NAME : MCPサーバーの名前（デフォルト: "openapi-mcp-server")
SERVER_VERSION : MCPサーバーのバージョン（デフォルト: "1.0.0"）
DEBUG : デバッグログを有効にする (true/false) (デフォルト: false)

使用法

サーバーの実行

サーバーは、JavaScript バージョンと TypeScript バージョンの両方で提供されます。

# Run JavaScript version npm start # Or run TypeScript version (compiles on the fly) npm run start:ts

TypeScriptバージョンのビルド

npm run build cd dist node server.js

MCPツールプロバイダーとしての使用

このサーバーはモデルコンテキストプロトコル (MCP) を実装しており、Claude.js クライアントやその他の MCP コンシューマーなど、MCP 互換のコンシューマーで使用できます。

Claude.js クライアントからこのサーバーに接続する例:

import { MCP } from "claude-js"; import { createStdio } from "claude-js/mcp"; // Create stdin/stdout transport const transport = createStdio({ command: "node path/to/server.js" }); // Connect to the MCP server const mcp = new MCP({ transport }); await mcp.connect(); // List available tools const { tools } = await mcp.listTools(); console.log("Available tools:", tools); // Call a tool const result = await mcp.callTool({ id: "TOOL-ID", arguments: { param1: "value1" } }); console.log("Tool result:", result);

利用可能なツール

この MCP サーバーは次のツールを提供します。

削除ツール

ID : DELETE-v1-tools-tool-id
説明: 名前でツールを削除します
方法: DELETE
パス: /v1/tools/{tool_id}

パラメータ:

tool_id : tool_idパラメータ（必須）
user_id : user_idパラメータ

取得ツール

ID : GET-v1-tools-tool-id
説明: IDでツールを取得する
メソッド: GET
パス: /v1/tools/{tool_id}

パラメータ:

tool_id : tool_idパラメータ（必須）
user_id : user_idパラメータ

修正ツール

ID : PATCH-v1-tools-tool-id
説明: 既存のツールを更新する
方法： PATCH
パス: /v1/tools/{tool_id}

パラメータ:

tool_id : tool_idパラメータ（必須）
user_id : user_idパラメータ

リストツール

ID : GET-v1-tools-
説明: ユーザーの組織に属するエージェントが利用できるすべてのツールのリストを取得します
メソッド: GET
パス: /v1/tools/

パラメータ:

after : パラメータの後
limit : 制限パラメータ
name : 名前パラメータ
user_id : user_idパラメータ

作成ツール

ID : POST-v1-tools-
説明: 新しいツールを作成する
メソッド: POST
パス: /v1/tools/

パラメータ:

user_id : user_idパラメータ

upsert_tool

ID : PUT-v1-tools-
説明: ツールを作成または更新する
メソッド: PUT
パス: /v1/tools/

パラメータ:

user_id : user_idパラメータ

ベースツールを追加する

ID : POST-v1-tools-add-base-tools
説明: アップサートベースツール
メソッド: POST
パス: /v1/tools/add-base-tools

パラメータ:

user_id : user_idパラメータ

ソースからツールを実行する

ID : POST-v1-tools-run
説明: ソースからツールをビルドし、指定された引数で実行します
メソッド: POST
パス: /v1/tools/run

パラメータ:

user_id : user_idパラメータ

リスト_コンポジション_アプリ

ID : GET-v1-tools-composio-apps
説明: すべての Composio アプリのリストを取得します
メソッド: GET
パス: /v1/tools/composio/apps

パラメータ:

user-id : ユーザーIDパラメータ

アプリごとのコンポジションアクションのリスト

ID : GET-v1-tools-composio-apps-composio-app-name-actions
説明: 特定のアプリのすべての Composio アクションのリストを取得します
メソッド: GET
パス: /v1/tools/composio/apps/{composio_app_name}/actions

パラメータ:

composio_app_name : composio_app_name パラメーター (必須)
user_id : user_idパラメータ

追加コンポジションツール

ID : POST-v1-tools-composio-composio-action-name
説明: アクション名で新しい Composio ツールを追加します (Composio は各ツールをActionと呼びます)
メソッド: POST
パス: /v1/tools/composio/{composio_action_name}

パラメータ:

composio_action_name : composio_action_name パラメータ（必須）
user_id : user_idパラメータ

mcp_servers の一覧

ID : GET-v1-tools-mcp-servers
説明: 設定されているすべてのMCPサーバーのリストを取得します
メソッド: GET
パス: /v1/tools/mcp/servers

パラメータ:

user-id : ユーザーIDパラメータ

add_mcp_server

ID : PUT-v1-tools-mcp-servers
説明: Letta MCP サーバー構成に新しい MCP サーバーを追加します
メソッド: PUT
パス: /v1/tools/mcp/servers

パラメータ:

user_id : user_idパラメータ

list_mcp_tools_by_server

ID : GET-v1-tools-mcp-servers-mcp-server-name-tools
説明: 特定のMCPサーバーのすべてのツールのリストを取得します
メソッド: GET
パス: /v1/tools/mcp/servers/{mcp_server_name}/tools

パラメータ:

mcp_server_name : mcp_server_name パラメータ（必須）
user_id : user_idパラメータ

追加_mcp_ツール

ID : POST-v1-tools-mcp-servers-mcp-server-name-mcp-tool-name
説明: MCPサーバー+ツール名で新しいMCPツールをLettaサーバーとして登録します
メソッド: POST
パス: /v1/tools/mcp/servers/{mcp_server_name}/{mcp_tool_name}

パラメータ:

mcp_server_name : mcp_server_name パラメータ（必須）
mcp_tool_name : mcp_tool_name パラメータ（必須）
user_id : user_idパラメータ

削除_mcp_server

ID : DELETE-v1-tools-mcp-servers-mcp-server-name
説明: Letta MCP サーバー構成に新しい MCP サーバーを追加します
方法: DELETE
パス: /v1/tools/mcp/servers/{mcp_server_name}

パラメータ:

mcp_server_name : mcp_server_name パラメータ（必須）
user_id : user_idパラメータ

取得元

ID : GET-v1-sources-source-id
説明: すべてのソースを取得
メソッド: GET
パス: /v1/sources/{source_id}

パラメータ:

source_id : source_idパラメータ（必須）
user_id : user_idパラメータ

ソースの変更

ID : PATCH-v1-sources-source-id
説明: 既存のデータソースの名前またはドキュメントを更新します。
方法： PATCH
パス: /v1/sources/{source_id}

パラメータ:

source_id : source_idパラメータ（必須）
user_id : user_idパラメータ

削除元

ID : DELETE-v1-sources-source-id
説明: データソースを削除します。
方法: DELETE
パス: /v1/sources/{source_id}

パラメータ:

source_id : source_idパラメータ（必須）
user_id : user_idパラメータ

名前でソースIDを取得する

ID : GET-v1-sources-name-source-name
説明: 名前でソースを取得する
メソッド: GET
パス: /v1/sources/name/{source_name}

パラメータ:

source_name : source_nameパラメータ（必須）
user_id : user_idパラメータ

リストソース

ID : GET-v1-sources-
説明: ユーザーが作成したすべてのデータソースを一覧表示します。
メソッド: GET
パス: /v1/sources/

パラメータ:

user_id : user_idパラメータ

作成ソース

ID : POST-v1-sources-
説明: 新しいデータソースを作成します。
メソッド: POST
パス: /v1/sources/

パラメータ:

user_id : user_idパラメータ

ソースにファイルをアップロードする

ID : POST-v1-sources-source-id-upload
説明: データソースにファイルをアップロードします。
メソッド: POST
パス: /v1/sources/{source_id}/upload

パラメータ:

source_id : source_idパラメータ（必須）
user_id : user_idパラメータ

リストソースパッセージ

ID : GET-v1-sources-source-id-passages
説明: データソースに関連付けられているすべてのパッセージを一覧表示します。
メソッド: GET
パス: /v1/sources/{source_id}/passages

パラメータ:

source_id : source_idパラメータ（必須）
user_id : user_idパラメータ

ソースファイルのリスト

ID : GET-v1-sources-source-id-files
説明: データソースに関連付けられたページ分割されたファイルを一覧表示します。
メソッド: GET
パス: /v1/sources/{source_id}/files

パラメータ:

source_id : source_idパラメータ（必須）
limit : 返されるファイルの数
after : 次の結果セットを取得するためのページネーションカーソル
user_id : user_idパラメータ

ソースからファイルを削除する

ID : DELETE-v1-sources-source-id-file-id
説明: データソースを削除します。
方法: DELETE
パス: /v1/sources/{source_id}/{file_id}

パラメータ:

source_id : source_idパラメータ（必須）
file_id : file_idパラメータ（必須）
user_id : user_idパラメータ

エージェント一覧

ID : GET-v1-agents-
説明: 特定のユーザーに関連付けられているすべてのエージェントを一覧表示します。

このエンドポイントは、指定されたユーザー ID に関連付けられているすべてのエージェントとその構成のリストを取得します。

メソッド: GET
パス: /v1/agents/

パラメータ:

name : エージェントの名前
tags : エージェントをフィルタリングするためのタグのリスト
match_all_tags : True の場合、指定されたタグのすべてに一致するエージェントのみを返します。それ以外の場合は、渡されたタグのいずれかを持つエージェントを返します。
before : ページ区切りのカーソル
after : ページ区切りのカーソル
limit : ページネーションの制限
query_text : エージェントを名前で検索
project_id : プロジェクトIDでエージェントを検索
template_id : テンプレートIDでエージェントを検索
base_template_id : ベーステンプレートIDでエージェントを検索
identity_id : ID IDでエージェントを検索
identifier_keys : 識別子キーでエージェントを検索
include_relationships : レスポンスに含めるリレーショナルフィールド（例：'tools'、'sources'、'memory'）を指定します。指定しない場合は、デフォルトですべてのリレーションシップが読み込まれます。このオプションを使用すると、不要な結合が削減され、パフォーマンスを最適化できます。
ascending : エージェントを古い順に並べ替える(True)か、新しい順に並べ替える(False、デフォルト)か
user_id : user_idパラメータ

エージェント作成

ID : POST-v1-agents-
説明: 指定された構成で新しいエージェントを作成します。
メソッド: POST
パス: /v1/agents/

パラメータ:

user_id : user_idパラメータ
X-Project : X-Projectパラメータ

エクスポートエージェントのシリアル化

ID : GET-v1-agents-agent-id-export
説明: エージェントのシリアル化された JSON 表現をエクスポートします。
メソッド: GET
パス: /v1/agents/{agent_id}/export

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

インポートエージェントのシリアル化

ID : POST-v1-agents-import
説明: シリアル化されたエージェントファイルをインポートし、システムにエージェントを再作成します。
メソッド: POST
パス: /v1/agents/import

パラメータ:

append_copy_suffix : True に設定すると、エージェント名の末尾に「_copy」が追加されます。
override_existing_tools : True に設定すると、アップロードされたツール定義によって既存のツールのソースコードが上書きされます。Letta コアツールは外部から更新できないことに注意してください。
project_id : アップロードされたエージェントを関連付けるプロジェクト ID。
user_id : user_idパラメータ

エージェントコンテキストウィンドウの取得

ID : GET-v1-agents-agent-id-context
説明: 特定のエージェントのコンテキストウィンドウを取得します。
メソッド: GET
パス: /v1/agents/{agent_id}/context

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

エージェントの変更

ID : PATCH-v1-agents-agent-id
説明: 既存のエージェントを更新する
方法： PATCH
パス: /v1/agents/{agent_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

取得エージェント

ID : GET-v1-agents-agent-id
説明: エージェントの状態を取得します。
メソッド: GET
パス: /v1/agents/{agent_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

エージェント削除

ID : DELETE-v1-agents-agent-id
説明: エージェントを削除します。
方法: DELETE
パス: /v1/agents/{agent_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

リストエージェントツール

ID : GET-v1-agents-agent-id-tools
説明: 既存のエージェントからツールを取得する
メソッド: GET
パス: /v1/agents/{agent_id}/tools

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

アタッチツール

ID : PATCH-v1-agents-agent-id-tools-attach-tool-id
説明: エージェントにツールをアタッチします。
方法： PATCH
パス: /v1/agents/{agent_id}/tools/attach/{tool_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
tool_id : tool_idパラメータ（必須）
user_id : user_idパラメータ

デタッチツール

ID : PATCH-v1-agents-agent-id-tools-detach-tool-id
説明: エージェントからツールをデタッチします。
方法： PATCH
パス: /v1/agents/{agent_id}/tools/detach/{tool_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
tool_id : tool_idパラメータ（必須）
user_id : user_idパラメータ

エージェントにソースをアタッチする

ID : PATCH-v1-agents-agent-id-sources-attach-source-id
説明: エージェントにソースを接続します。
方法： PATCH
パス: /v1/agents/{agent_id}/sources/attach/{source_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
source_id : source_idパラメータ（必須）
user_id : user_idパラメータ

エージェントからソースをデタッチする

ID : PATCH-v1-agents-agent-id-sources-detach-source-id
説明: エージェントからソースを切り離します。
方法： PATCH
パス: /v1/agents/{agent_id}/sources/detach/{source_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
source_id : source_idパラメータ（必須）
user_id : user_idパラメータ

エージェントソースのリスト

ID : GET-v1-agents-agent-id-sources
説明: エージェントに関連付けられたソースを取得します。
メソッド: GET
パス: /v1/agents/{agent_id}/sources

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

エージェントのメモリ取得

ID : GET-v1-agents-agent-id-core-memory
説明: 特定のエージェントのメモリ状態を取得します。このエンドポイントは、ユーザーIDとエージェントIDで識別されるエージェントの現在のメモリ状態を取得します。
メソッド: GET
パス: /v1/agents/{agent_id}/core-memory

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

コアメモリブロックの取得

ID : GET-v1-agents-agent-id-core-memory-blocks-block-label
説明: エージェントからコアメモリブロックを取得します。
メソッド: GET
パス: /v1/agents/{agent_id}/core-memory/blocks/{block_label}

パラメータ:

agent_id : agent_idパラメータ（必須）
block_label : block_labelパラメータ（必須）
user_id : user_idパラメータ

コアメモリブロックの変更

ID : PATCH-v1-agents-agent-id-core-memory-blocks-block-label
説明: エージェントのコアメモリブロックを更新します。
方法： PATCH
パス: /v1/agents/{agent_id}/core-memory/blocks/{block_label}

パラメータ:

agent_id : agent_idパラメータ（必須）
block_label : block_labelパラメータ（必須）
user_id : user_idパラメータ

コアメモリブロックの一覧

ID : GET-v1-agents-agent-id-core-memory-blocks
説明: 特定のエージェントのコアメモリブロックを取得します。
メソッド: GET
パス: /v1/agents/{agent_id}/core-memory/blocks

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

コアメモリブロックを接続する

ID : PATCH-v1-agents-agent-id-core-memory-blocks-attach-block-id
説明: コアメモリブロックをエージェントに接続します。
方法： PATCH
パス: /v1/agents/{agent_id}/core-memory/blocks/attach/{block_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
block_id : block_idパラメータ（必須）
user_id : user_idパラメータ

コアメモリブロックのデタッチ

ID : PATCH-v1-agents-agent-id-core-memory-blocks-detach-block-id
説明: エージェントからコアメモリブロックをデタッチします。
方法： PATCH
パス: /v1/agents/{agent_id}/core-memory/blocks/detach/{block_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
block_id : block_idパラメータ（必須）
user_id : user_idパラメータ

リストパッセージ

ID : GET-v1-agents-agent-id-archival-memory
説明: エージェントのアーカイブメモリストア内のメモリを取得します (ページ分割されたクエリ)。
メソッド: GET
パス: /v1/agents/{agent_id}/archival-memory

パラメータ:

agent_id : agent_idパラメータ（必須）
after : クエリ範囲を開始するメモリの一意の ID。
before : クエリ範囲を終了するメモリの一意の ID。
limit : レスポンスに含める結果の数。
search : テキストで文章を検索
ascending : 文章を古い順に並べ替えるか(True、デフォルト)、新しい順に並べ替えるか(False)
user_id : user_idパラメータ

パスの作成

ID : POST-v1-agents-agent-id-archival-memory
説明: エージェントのアーカイブメモリストアにメモリを挿入します。
メソッド: POST
パス: /v1/agents/{agent_id}/archival-memory

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

文章の変更

ID : PATCH-v1-agents-agent-id-archival-memory-memory-id
説明: エージェントのアーカイブメモリストア内のメモリを変更します。
方法： PATCH
パス: /v1/agents/{agent_id}/archival-memory/{memory_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
memory_id : メモリIDパラメータ（必須）
user_id : user_idパラメータ

削除する

ID : DELETE-v1-agents-agent-id-archival-memory-memory-id
説明: エージェントのアーカイブメモリストアからメモリを削除します。
方法: DELETE
パス: /v1/agents/{agent_id}/archival-memory/{memory_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
memory_id : メモリIDパラメータ（必須）
user_id : user_idパラメータ

リストメッセージ

ID : GET-v1-agents-agent-id-messages
説明: エージェントのメッセージ履歴を取得します。
メソッド: GET
パス: /v1/agents/{agent_id}/messages

パラメータ:

agent_id : agent_idパラメータ（必須）
after : 返されるメッセージを取得する前のメッセージ。
before : 返されるメッセージを取得する前のメッセージ。
limit : 取得するメッセージの最大数。
use_assistant_message : アシスタントメッセージを使用するかどうか
assistant_message_tool_name : 指定されたメッセージツールの名前。
assistant_message_tool_kwarg : メッセージ引数の名前。
user_id : user_idパラメータ

メッセージを送信

ID : POST-v1-agents-agent-id-messages
説明: ユーザーメッセージを処理し、エージェントの応答を返します。このエンドポイントはユーザーからのメッセージを受け取り、エージェントを介して処理します。
メソッド: POST
パス: /v1/agents/{agent_id}/messages

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

メッセージの変更

ID : PATCH-v1-agents-agent-id-messages-message-id
説明: エージェントに関連付けられたメッセージの詳細を更新します。
方法： PATCH
パス: /v1/agents/{agent_id}/messages/{message_id}

パラメータ:

agent_id : agent_idパラメータ（必須）
message_id : message_idパラメータ（必須）
user_id : user_idパラメータ

エージェントメッセージストリームの作成

ID : POST-v1-agents-agent-id-messages-stream
説明: ユーザーメッセージを処理し、エージェントのレスポンスを返します。このエンドポイントはユーザーからのメッセージを受け取り、エージェントを介して処理します。レスポンスのステップは常にストリーミングされ、'stream_tokens' が True に設定されている場合はトークンもストリーミングされます。
メソッド: POST
パス: /v1/agents/{agent_id}/messages/stream

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

エージェントメッセージ非同期作成

ID : POST-v1-agents-agent-id-messages-async
説明: ユーザーメッセージを非同期に処理し、実行オブジェクトを返します。実際の処理はバックグラウンドで行われ、実行IDを使用してステータスを確認できます。
メソッド: POST
パス: /v1/agents/{agent_id}/messages/async

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

リセットメッセージ

ID : PATCH-v1-agents-agent-id-reset-messages
説明: エージェントのメッセージをリセットします
方法： PATCH
パス: /v1/agents/{agent_id}/reset-messages

パラメータ:

agent_id : agent_idパラメータ（必須）
add_default_initial_messages : true の場合、リセット後にデフォルトの初期メッセージを追加します。
user_id : user_idパラメータ

グループを作成する

ID : POST-v1-groups-
説明: 指定された構成で新しいマルチエージェントグループを作成します。
メソッド: POST
パス: /v1/groups/

パラメータ:

user_id : user_idパラメータ
X-Project : X-Projectパラメータ

リストグループ

ID : GET-v1-groups-
説明: クエリに一致するすべてのマルチエージェントグループを取得します。
メソッド: GET
パス: /v1/groups/

パラメータ:

manager_type : マネージャーの種類でグループを検索
before : ページ区切りのカーソル
after : ページ区切りのカーソル
limit : ページ区切りの制限
project_id : プロジェクトIDでグループを検索
user_id : user_idパラメータ

upsert_group

ID : PUT-v1-groups-
説明: 指定された構成で新しいマルチエージェントグループを作成します。
メソッド: PUT
パス: /v1/groups/

パラメータ:

user_id : user_idパラメータ
X-Project : X-Projectパラメータ

グループを削除

ID : DELETE-v1-groups-group-id
説明: マルチエージェントグループを削除します。
方法: DELETE
パス: /v1/groups/{group_id}

パラメータ:

group_id : group_idパラメータ（必須）
user_id : user_idパラメータ

グループメッセージを送信する

ID : POST-v1-groups-group-id-messages
説明: ユーザーメッセージを処理し、グループのレスポンスを返します。このエンドポイントは、ユーザーからのメッセージを受け取り、指定されたパターンに基づいてグループ内のエージェントを通じてメッセージを処理します。
メソッド: POST
パス: /v1/groups/{group_id}/messages

パラメータ:

agent_id : agent_idパラメータ（必須）
user_id : user_idパラメータ

グループメッセージ一覧

ID : GET-v1-groups-group-id-messages
説明: エージェントのメッセージ履歴を取得します。
メソッド: GET
パス: /v1/groups/{group_id}/messages

パラメータ:

group_id : group_idパラメータ（必須）
after : 返されるメッセージを取得する前のメッセージ。
before : 返されるメッセージを取得する前のメッセージ。
limit : 取得するメッセージの最大数。
use_assistant_message : アシスタントメッセージを使用するかどうか
assistant_message_tool_name : 指定されたメッセージツールの名前。
assistant_message_tool_kwarg : メッセージ引数の名前。
user_id : user_idパラメータ

グループメッセージのストリーミング送信

ID : POST-v1-groups-group-id-messages-stream
説明: ユーザーメッセージを処理し、グループのレスポンスを返します。このエンドポイントは、ユーザーからのメッセージを受け取り、指定されたパターンに基づいてグループ内のエージェントを介して処理します。レスポンスのステップは常にストリーミングされ、'stream_tokens' が True に設定されている場合はトークンもストリーミングされます。
メソッド: POST
パス: /v1/groups/{group_id}/messages/stream

パラメータ:

group_id : group_idパラメータ（必須）
user_id : user_idパラメータ

リストID

ID : GET-v1-identities-
説明: データベース内のすべてのIDのリストを取得します
メソッド: GET
パス: /v1/identities/

パラメータ:

name : 名前パラメータ
project_id : project_idパラメータ
identifier_key : identifier_key パラメータ
identity_type : identity_typeパラメータ
before : 前のパラメータ
after : パラメータの後
limit : 制限パラメータ
user_id : user_idパラメータ

アイデンティティ作成

ID : POST-v1-identities-
説明: /v1/identities/ に POST リクエストを送信します
メソッド: POST
パス: /v1/identities/

パラメータ:

user_id : user_idパラメータ
X-Project : X-Projectパラメータ

upsert_identity

ID : PUT-v1-identities-
説明: /v1/identities/ に PUT リクエストを送信します。
メソッド: PUT
パス: /v1/identities/

パラメータ:

user_id : user_idパラメータ
X-Project : X-Projectパラメータ

ID取得

ID : GET-v1-identities-identity-id
説明: /v1/identities/{identity_id} に GET リクエストを送信します。
メソッド: GET
パス: /v1/identities/{identity_id}

パラメータ:

identity_id : identity_idパラメータ（必須）
user_id : user_idパラメータ

更新ID

ID : PATCH-v1-identities-identity-id
説明: /v1/identities/{identity_id} に PATCH リクエストを送信します
方法： PATCH
パス: /v1/identities/{identity_id}

パラメータ:

identity_id : identity_idパラメータ（必須）
user_id : user_idパラメータ

削除ID

ID : DELETE-v1-identities-identity-id
説明: 識別子キーでアイデンティティを削除します
方法: DELETE
パス: /v1/identities/{identity_id}

パラメータ:

identity_id : identity_idパラメータ（必須）
user_id : user_idパラメータ

リストモデル

ID : GET-v1-models-
説明: /v1/models/ に GET リクエストを送信します
メソッド: GET
パス: /v1/models/

パラメータは必要ありません。

リスト埋め込みモデル

ID : GET-v1-models-embedding
説明: /v1/models/embedding に GET リクエストを送信します
メソッド: GET
パス: /v1/models/embedding

パラメータは必要ありません。

リストブロック

ID : GET-v1-blocks-
説明: /v1/blocks/ に GET リクエストを送信します
メソッド: GET
パス: /v1/blocks/

パラメータ:

label : 含めるラベル (例: human、persona)
templates_only : テンプレートのみを含めるかどうか
name : ブロックの名前
identity_id : 識別子IDでエージェントを検索
identifier_keys : 識別子キーでエージェントを検索
user_id : user_idパラメータ

ブロックを作成する

ID : POST-v1-blocks-
説明: /v1/blocks/ に POST リクエストを送信します
メソッド: POST
パス: /v1/blocks/

パラメータ:

user_id : user_idパラメータ

ブロックの変更

ID : PATCH-v1-blocks-block-id
説明: /v1/blocks/{block_id} に PATCH リクエストを送信します
方法： PATCH
パス: /v1/blocks/{block_id}

パラメータ:

block_id : block_idパラメータ（必須）
user_id : user_idパラメータ

削除ブロック

ID : DELETE-v1-blocks-block-id
説明: /v1/blocks/{block_id} に DELETE リクエストを送信します。
方法: DELETE
パス: /v1/blocks/{block_id}

パラメータ:

block_id : block_idパラメータ（必須）
user_id : user_idパラメータ

ブロックの取得

ID : GET-v1-blocks-block-id
説明: /v1/blocks/{block_id} に GET リクエストを送信します。
メソッド: GET
パス: /v1/blocks/{block_id}

パラメータ:

block_id : block_idパラメータ（必須）
user_id : user_idパラメータ

ブロック用エージェント一覧

ID : GET-v1-blocks-block-id-agents
説明: 指定されたブロックに関連付けられているすべてのエージェントを取得します。ブロックが存在しない場合は404エラーが発生します。
メソッド: GET
パス: /v1/blocks/{block_id}/agents

パラメータ:

block_id : block_idパラメータ（必須）
user_id : user_idパラメータ

リストジョブ

ID : GET-v1-jobs-
説明: すべてのジョブを一覧表示します。
メソッド: GET
パス: /v1/jobs/

パラメータ:

source_id : ソースに関連付けられたジョブのみを一覧表示します。
user_id : user_idパラメータ

アクティブな求人の一覧

ID : GET-v1-jobs-active
説明: すべてのアクティブなジョブを一覧表示します。
メソッド: GET
パス: /v1/jobs/active

パラメータ:

user_id : user_idパラメータ

ジョブの取得

ID : GET-v1-jobs-job-id
説明: ジョブのステータスを取得します。
メソッド: GET
パス: /v1/jobs/{job_id}

パラメータ:

job_id : job_idパラメータ（必須）
user_id : user_idパラメータ

ジョブの削除

ID : DELETE-v1-jobs-job-id
説明: job_id でジョブを削除します。
方法: DELETE
パス: /v1/jobs/{job_id}

パラメータ:

job_id : job_idパラメータ（必須）
user_id : user_idパラメータ

ヘルスチェック

ID : GET-v1-health-
説明: /v1/health/ に GET リクエストを送信します
メソッド: GET
パス: /v1/health/

パラメータは必要ありません。

サンドボックス設定の作成_v1_サンドボックス設定__post

ID : POST-v1-sandbox-config-
説明: /v1/sandbox-config/ に POST リクエストを送信します
メソッド: POST
パス: /v1/sandbox-config/

パラメータ:

user-id : ユーザーIDパラメータ

list_sandbox_configs_v1_sandbox_config__get

ID : GET-v1-sandbox-config-
説明: /v1/sandbox-config/ に GET リクエストを送信します。
メソッド: GET
パス: /v1/sandbox-config/

パラメータ:

limit : 返される結果の数
after : 次の結果セットを取得するためのページネーションカーソル
sandbox_type : この特定のサンドボックスタイプをフィルターします
user-id : ユーザーIDパラメータ

作成_default_e2b_sandbox_config_v1_sandbox_config_e2b_default_post

ID : POST-v1-sandbox-config-e2b-default
説明: /v1/sandbox-config/e2b/default にPOSTリクエストを送信します
メソッド: POST
パス: /v1/sandbox-config/e2b/default

パラメータ:

user-id : ユーザーIDパラメータ

ローカルサンドボックスのデフォルト設定を投稿する

ID : POST-v1-sandbox-config-local-default
説明: /v1/sandbox-config/local/default にPOSTリクエストを送信します
メソッド: POST
パス: /v1/sandbox-config/local/default

パラメータ:

user-id : ユーザーIDパラメータ

カスタムローカルサンドボックス設定 v1 サンドボックス設定ローカル投稿を作成します

ID : POST-v1-sandbox-config-local
説明: pip_requirements を含むカスタム LocalSandboxConfig を作成または更新します。
メソッド: POST
パス: /v1/sandbox-config/local

パラメータ:

user-id : ユーザーIDパラメータ

アップデート_サンドボックス_config_v1_サンドボックス_config__サンドボックス_config_id__パッチ

ID : PATCH-v1-sandbox-config-sandbox-config-id
説明: /v1/sandbox-config/{sandbox_config_id} に PATCH リクエストを送信します
方法： PATCH
パス: /v1/sandbox-config/{sandbox_config_id}

パラメータ:

sandbox_config_id : sandbox_config_id パラメータ (必須)
user-id : ユーザーIDパラメータ

削除_sandbox_config_v1_sandbox_config__sandbox_config_id__delete

ID : DELETE-v1-sandbox-config-sandbox-config-id
説明: /v1/sandbox-config/{sandbox_config_id} に DELETE リクエストを実行します。
方法: DELETE
パス: /v1/sandbox-config/{sandbox_config_id}

パラメータ:

sandbox_config_id : sandbox_config_id パラメータ (必須)
user-id : ユーザーIDパラメータ

ローカルサンドボックスの再作成を強制する_venv_v1_sandbox_config_local_recreate_venv_post

ID : POST-v1-sandbox-config-local-recreate-venv
説明: ローカルサンドボックスの仮想環境を強制的に再作成します。venv を削除して再作成し、必要な依存関係を再インストールします。
メソッド: POST
パス: /v1/sandbox-config/local/recreate-venv

パラメータ:

user-id : ユーザーIDパラメータ

サンドボックス環境変数_v1_sandbox_config__sandbox_config_id__環境変数_postを作成します

ID : POST-v1-sandbox-config-sandbox-config-id-environment-variable
説明: /v1/sandbox-config/{sandbox_config_id}/environment-variable にPOSTリクエストを送信します。
メソッド: POST
パス: /v1/sandbox-config/{sandbox_config_id}/environment-variable

パラメータ:

sandbox_config_id : sandbox_config_id パラメータ (必須)
user-id : ユーザーIDパラメータ

リスト_サンドボックス_env_vars_v1_sandbox_config__サンドボックス_config_id__環境変数_get

ID : GET-v1-sandbox-config-sandbox-config-id-environment-variable
説明: /v1/sandbox-config/{sandbox_config_id}/environment-variable にGETリクエストを送信します。
メソッド: GET
パス: /v1/sandbox-config/{sandbox_config_id}/environment-variable

パラメータ:

sandbox_config_id : sandbox_config_id パラメータ (必須)
limit : 返される結果の数
after : 次の結果セットを取得するためのページネーションカーソル
user-id : ユーザーIDパラメータ

アップデート_サンドボックス_env_var_v1_サンドボックス_config_環境変数__env_var_id__パッチ

ID : PATCH-v1-sandbox-config-environment-variable-env-var-id
説明: /v1/sandbox-config/environment-variable/{env_var_id} に PATCH リクエストを送信します。
方法： PATCH
パス: /v1/sandbox-config/environment-variable/{env_var_id}

パラメータ:

env_var_id : env_var_id パラメータ（必須）
user-id : ユーザーIDパラメータ

サンドボックス環境変数の削除

ID : DELETE-v1-sandbox-config-environment-variable-env-var-id
説明: /v1/sandbox-config/environment-variable/{env_var_id} に DELETE リクエストを実行します。
方法: DELETE
パス: /v1/sandbox-config/environment-variable/{env_var_id}

パラメータ:

env_var_id : env_var_id パラメータ（必須）
user-id : ユーザーIDパラメータ

リストプロバイダー

ID : GET-v1-providers-
説明: データベース内のすべてのカスタムプロバイダーのリストを取得します
メソッド: GET
パス: /v1/providers/

パラメータ:

after : パラメータの後
limit : 制限パラメータ
user_id : user_idパラメータ

プロバイダーの作成

ID : POST-v1-providers-
説明: 新しいカスタムプロバイダーを作成する
メソッド: POST
パス: /v1/providers/

パラメータ:

user_id : user_idパラメータ

プロバイダーの変更

ID : PATCH-v1-providers-
説明: 既存のカスタムプロバイダーを更新する
方法： PATCH
パス: /v1/providers/

パラメータ:

user_id : user_idパラメータ

プロバイダーの削除

ID : DELETE-v1-providers-
説明: 既存のカスタムプロバイダーを削除します
方法: DELETE
パス: /v1/providers/

パラメータ:

provider_id : 削除するprovider_idキー。(必須)
user_id : user_idパラメータ

リスト実行

ID : GET-v1-runs-
説明: すべての実行を一覧表示します。
メソッド: GET
パス: /v1/runs/

パラメータ:

user_id : user_idパラメータ

アクティブな実行の一覧

ID : GET-v1-runs-active
説明: すべてのアクティブな実行を一覧表示します。
メソッド: GET
パス: /v1/runs/active

パラメータ:

user_id : user_idパラメータ

取得実行

ID : GET-v1-runs-run-id
説明: 実行のステータスを取得します。
メソッド: GET
パス: /v1/runs/{run_id}

パラメータ:

run_id : run_id パラメータ（必須）
user_id : user_idパラメータ

削除実行

ID : DELETE-v1-runs-run-id
説明: run_id で実行を削除します。
方法: DELETE
パス: /v1/runs/{run_id}

パラメータ:

run_id : run_id パラメータ（必須）
user_id : user_idパラメータ

リスト実行メッセージ

ID : GET-v1-runs-run-id-messages
説明: フィルタリングオプションを使用して実行に関連付けられたメッセージを取得します。

引数: run_id: 実行ID before: ページ区切りで使用するカーソル。before beforeリスト内の位置を定義するオブジェクトIDです。例えば、リストリクエストを行い、obj_fooで始まる100個のオブジェクトを受け取った場合、後続の呼び出しでbefore=obj_fooを含めることでリストの前のページを取得できます。 after: ページ区切りで使用するカーソル。after afterリスト内の位置を定義するオブジェクトIDです。例えば、リストリクエストを行い、obj_fooで終わる100個のオブジェクトを受け取った場合、後続の呼び出しでafter=obj_fooを含めることでリストの次のページを取得できます。 limit: 返されるメッセージの最大数 order: オブジェクトのcreated_atタイムスタンプによるソート順。昇順の場合はasc、降順の場合はdesc。 role: ロール（ユーザー/アシスタント/システム/ツール）によるフィルタリング return_message_object: Messageオブジェクトを返すか、LettaMessageオブジェクトを返すか user_id: リクエストを行ったユーザーのID

戻り値: 実行に関連付けられたメッセージのリスト。デフォルトはList[LettaMessage]です。

メソッド: GET
パス: /v1/runs/{run_id}/messages

パラメータ:

run_id : run_id パラメータ（必須）
before : ページ区切りのカーソル
after : ページ区切りのカーソル
limit : 返されるメッセージの最大数
order : オブジェクトの created_at タイムスタンプで並べ替えます。昇順の場合は asc、降順の場合は desc です。
role : 役割でフィルタリング
user_id : user_idパラメータ

実行使用状況の取得

ID : GET-v1-runs-run-id-usage
説明: 実行の使用状況統計を取得します。
メソッド: GET
パス: /v1/runs/{run_id}/usage

パラメータ:

run_id : run_id パラメータ（必須）
user_id : user_idパラメータ

実行ステップのリスト

ID : GET-v1-runs-run-id-steps
説明: フィルタリングオプションを使用して実行に関連付けられたメッセージを取得します。

引数: run_id: 実行の ID before: ページ区切りで使用するカーソル。 beforeリスト内の位置を定義するオブジェクト ID です。たとえば、リスト要求を行って、obj_foo で始まる 100 個のオブジェクトを受け取った場合、後続の呼び出しで before=obj_foo を含めることでリストの前のページを取得できます。 after: ページ区切りで使用するカーソル。 afterリスト内の位置を定義するオブジェクト ID です。たとえば、リスト要求を行って、obj_foo で終わる 100 個のオブジェクトを受け取った場合、後続の呼び出しで after=obj_foo を含めることでリストの次のページを取得できます。 limit: 返す最大ステップ数 order: オブジェクトの created_at タイムスタンプで並べ替えます。昇順の場合は asc、降順の場合は desc です。

戻り値: 実行に関連付けられたステップのリスト。

メソッド: GET
パス: /v1/runs/{run_id}/steps

パラメータ:

run_id : run_id パラメータ（必須）
before : ページ区切りのカーソル
after : ページ区切りのカーソル
limit : 返されるメッセージの最大数
order : オブジェクトの created_at タイムスタンプで並べ替えます。昇順の場合は asc、降順の場合は desc です。
user_id : user_idパラメータ

リストステップ

ID : GET-v1-steps
説明: オプションのページ区切りと日付フィルター付きのリストステップ。日付はISO 8601形式で指定してください（例：2025-01-29T15:01:19-08:00）。
メソッド: GET
パス: /v1/steps

パラメータ:

before : このステップIDの前のステップを返す
after : このステップID以降のステップを返す
limit : 返されるステップの最大数
order : ソート順（昇順または降順）
start_date : このISO日時以降のステップを返します（例： "2025-01-29T15:01:19-08:00"）
end_date : このISO日時より前のステップを返します（例： "2025-01-29T15:01:19-08:00"）
model : ステップに使用されたモデルの名前でフィルタリングします
agent_id : ステップを実行したエージェントのIDでフィルタリングします
user_id : user_idパラメータ

取得ステップ

ID : GET-v1-steps-step-id
説明: ID でステップを取得します。
メソッド: GET
パス: /v1/steps/{step_id}

パラメータ:

step_id : step_idパラメータ（必須）
user_id : user_idパラメータ

更新ステップトランザクションID

ID : PATCH-v1-steps-step-id-transaction-transaction-id
説明: ステップのトランザクション ID を更新します。
方法： PATCH
パス: /v1/steps/{step_id}/transaction/{transaction_id}

パラメータ:

step_id : step_idパラメータ（必須）
transaction_id : transaction_idパラメータ（必須）
user_id : user_idパラメータ

リストタグ

ID : GET-v1-tags-
説明: データベース内のすべてのタグのリストを取得します
メソッド: GET
パス: /v1/tags/

パラメータ:

after : パラメータの後
limit : 制限パラメータ
query_text : クエリテキストパラメータ
user_id : user_idパラメータ

ボイスチャット補完の作成

ID : POST-v1-voice-beta-agent-id-chat-completions
説明: /v1/voice-beta/{agent_id}/chat/completions にPOSTリクエストを送信します。
メソッド: POST
パス: /v1/voice-beta/{agent_id}/chat/completions

パラメータ:

agent_id : agent_idパラメータ（必須）
user-id : ユーザーIDパラメータ

リストユーザー

ID : GET-v1-admin-users-
説明: データベース内のすべてのユーザーのリストを取得します
メソッド: GET
パス: /v1/admin/users/

パラメータ:

after : パラメータの後
limit : 制限パラメータ

ユーザー作成

ID : POST-v1-admin-users-
説明: データベースに新しいユーザーを作成する
メソッド: POST
パス: /v1/admin/users/

パラメータは必要ありません。

更新ユーザー

ID : PUT-v1-admin-users-
説明: データベース内のユーザーを更新する
メソッド: PUT
パス: /v1/admin/users/

パラメータは必要ありません。

ユーザー削除

ID : DELETE-v1-admin-users-
説明: /v1/admin/users/ に DELETE リクエストを発行する
方法: DELETE
パス: /v1/admin/users/

パラメータ:

user_id : 削除する user_id キー。(必須)

リスト組織

ID : GET-v1-admin-orgs-
説明: データベース内のすべての組織のリストを取得します
メソッド: GET
パス: /v1/admin/orgs/

パラメータ:

after : パラメータの後
limit : 制限パラメータ

組織の作成

ID : POST-v1-admin-orgs-
説明: データベースに新しい組織を作成する
メソッド: POST
パス: /v1/admin/orgs/

パラメータは必要ありません。

組織IDによる削除

ID : DELETE-v1-admin-orgs-
説明: /v1/admin/orgs/ に DELETE リクエストを実行します。
方法: DELETE
パス: /v1/admin/orgs/

パラメータ:

org_id : 削除する org_id キー。(必須)

組織の更新

ID : PATCH-v1-admin-orgs-
説明: /v1/admin/orgs/ に PATCH リクエストを送信します
方法： PATCH
パス: /v1/admin/orgs/

パラメータ:

org_id : 更新する org_id キー。(必須)

チャット補完の作成

ID : POST-openai-v1-agent-id-chat-completions
説明: /openai/v1/{agent_id}/chat/completions にPOSTリクエストを送信します。
メソッド: POST
パス: /openai/v1/{agent_id}/chat/completions

パラメータ:

agent_id : agent_idパラメータ（必須）
user-id : ユーザーIDパラメータ

認証_ユーザー_v1_認証_投稿

ID : POST-v1-auth
説明: ユーザーを認証し、ユーザー関連データを含む応答を送信します。

現在、これは単にUUIDプレースホルダーを返すプレースホルダーです

メソッド: POST
パス: /v1/auth

パラメータは必要ありません。

ライセンス

マサチューセッツ工科大学