> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/tech/ja/api-integration/endpoint-behaviors.md).

# エンドポイントの動作に関する補足

個々の API エンドポイントについて、フィールド定義だけでは表せない可視範囲、イベントの意味、並び順、互換性の変更を説明します。

各エンドポイントのフィールド仕様（パス、パラメータ、リクエストとレスポンスのフィールド、型、必須項目）は、[API ドキュメント](https://docs.maiagent.ai/api)を正とします。このセクションでは、スキーマで表現できない動作のみを扱います。たとえば、以下の内容です。

* **可視範囲**：同じエンドポイントでも、呼び出し元の権限や立場によって参照できるデータがどう異なるかを説明します。
* **イベントの意味**：リアルタイムイベントがいつ送信され、何を意味し、受信後にどう処理すべきかを説明します。
* **並び順**：一覧がどの順序で返され、連携側で並べ替えが可能かを説明します。
* **互換性の変更**：既存の連携が動作しなくなる変更と、必要な対応を説明します。

## このセクションのページ <a href="#pages" id="pages"></a>

| ページ                                                                                                 | 補足する動作                                |
| --------------------------------------------------------------------------------------------------- | ------------------------------------- |
| [会話添付ファイル管理 API](/tech/ja/api-integration/endpoint-behaviors/conversation-attachments.md)           | 可視範囲、有効期限の計算方法                        |
| [会話出力一覧 API](/tech/ja/api-integration/endpoint-behaviors/conversation-outputs-api.md)               | 可視範囲、読み取り元、並べ替えとフィルタリングの規則、レスポンスフィールド |
| [会話の閲覧権限とリアルタイムイベント](/tech/ja/api-integration/endpoint-behaviors/conversation-visibility-events.md) | 可視範囲、リアルタイムイベント、未読数                   |
| [メンバーメモリ管理 API](/tech/ja/api-integration/endpoint-behaviors/member-memory-api.md)                   | 組織の範囲、メモリの状態                          |
| [サイトブランディング設定 API](/tech/ja/api-integration/endpoint-behaviors/branding-api.md)                     | ドメインによるブランドの決定、null 値の処理、レスポンスフィールド   |
| [Credits 項目の表示順序](/tech/ja/api-integration/endpoint-behaviors/credit-display-order.md)              | 並び順の規則                                |
| [Agent の回答モードと構造化出力フィールド](/tech/ja/api-integration/endpoint-behaviors/chatbot-reply-mode-api.md)    | フィールド値の対応、組み合わせの制約、レスポンスの構造           |
| [会話記録の使用量と Credits フィールド](/tech/ja/api-integration/endpoint-behaviors/chatbot-records-usage-api.md) | レスポンスフィールド、フィルタパラメータ、集計方法             |
| [組み込みワークフロー回答モードの廃止](/tech/ja/api-integration/endpoint-behaviors/workflow-reply-mode-retirement.md) | 互換性の変更                                |
| [会話プラットフォーム Credits 上限 API](/tech/ja/api-integration/endpoint-behaviors/inbox-credit-quota-api.md)  | 上限の割り当てと無効化、上限必須フラグによる効果の違い           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/tech/ja/api-integration/endpoint-behaviors.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.