> ## Documentation Index > Fetch the complete documentation index at: https://docs.dify.ai/llms.txt > Use this file to discover all available pages before exploring further. # ワークフローログ一覧を取得 > フィルタリングオプション付きでワークフロー実行ログをページネーションで取得します。 ## OpenAPI ````yaml /ja/api-reference/openapi_chatflow.json get /workflows/logs openapi: 3.0.1 info: title: 高度なチャットアプリAPI (Chatflow API) description: >- Chatflow アプリケーションはセッションの永続化をサポートし、過去のチャット履歴をレスポンスのコンテキストとして使用できます。Chatflow アプリは `advanced-chat` モードを使用し、ノードの開始・完了、イテレーション、ワークフローのライフサイクルを含む詳細な実行追跡のためのワークフローレベルのストリーミングイベントを提供します。 version: 1.0.0 servers: - url: https://{api_base_url} description: Chatflow アプリ API のベース URL です。セルフホスト環境では、独自の API ベース URL に置き換えてください。 variables: api_base_url: default: api.dify.ai/v1 description: API ベース URL のホストとパス（`https://` を除く）。 security: - ApiKeyAuth: [] tags: - name: チャットフロー description: チャットフローアプリケーションの操作です（チャットメッセージ、ワークフロー実行詳細、イベントストリーミングを含む）。 - name: ファイル操作 description: ファイルのアップロードとプレビューの操作です。 - name: エンドユーザー description: エンドユーザー情報に関連する操作です。 - name: メッセージフィードバック description: ユーザーフィードバックの操作です。 - name: 会話管理 description: 会話管理に関連する操作です。 - name: 音声・テキスト変換 description: テキスト読み上げと音声認識の操作です。 - name: アプリケーション設定 description: アプリケーション設定と情報を取得する操作です。 - name: アノテーション管理 description: ダイレクト返信用のアノテーション管理に関連する操作です。 - name: 人間の入力 description: 人間の入力を要する一時停止中のワークフローの再開操作です。 paths: /workflows/logs: get: tags: - チャットフロー summary: ワークフローログ一覧を取得 description: フィルタリングオプション付きでワークフロー実行ログをページネーションで取得します。 operationId: listChatflowWorkflowLogsJa parameters: - name: keyword in: query description: ログ内を検索するキーワードです。 schema: type: string - name: status in: query description: 実行ステータスでフィルタリングします。 schema: type: string enum: - succeeded - failed - stopped - name: page in: query description: ページネーションのページ番号。 schema: type: integer default: 1 minimum: 1 maximum: 99999 - name: limit in: query description: 1 ページあたりの件数です。 schema: type: integer default: 20 minimum: 1 maximum: 100 - name: created_at__before in: query description: この ISO 8601 タイムスタンプ以前に作成されたログをフィルタリングします。 schema: type: string format: date-time - name: created_at__after in: query description: この ISO 8601 タイムスタンプ以降に作成されたログをフィルタリングします。 schema: type: string format: date-time - name: created_by_end_user_session_id in: query description: エンドユーザーセッション ID でフィルタリングします。 schema: type: string - name: created_by_account in: query description: アカウント ID でフィルタリングします。 schema: type: string responses: '200': description: ワークフローログの取得に成功しました。 content: application/json: schema: $ref: '#/components/schemas/WorkflowLogsResponse' examples: workflowLogs: summary: レスポンス例 value: page: 1 limit: 20 total: 1 has_more: false data: - id: b7e2f8a1-3c4d-5e6f-7890-abcdef123456 workflow_run: id: fb47b2e6-5e43-4f90-be01-d5c5a088d156 version: '2025-01-16 12:00:00.000000' status: succeeded error: null elapsed_time: 1.23 total_tokens: 150 total_steps: 3 created_at: 1705407629 finished_at: 1705407630 exceptions_count: 0 created_from: service-api created_by_role: end_user created_by_account: null created_by_end_user: id: f1e2d3c4-b5a6-7890-abcd-ef1234567890 type: service_api is_anonymous: false session_id: user_chatflow_123 created_at: 1705407629 components: schemas: WorkflowLogsResponse: type: object properties: page: type: integer description: 現在のページ番号です。 limit: type: integer description: 1 ページあたりの件数です。 total: type: integer description: ログエントリの合計数です。 has_more: type: boolean description: さらにページがあるかどうかです。 data: type: array items: $ref: '#/components/schemas/WorkflowLogItem' description: ワークフローログエントリのリストです。 WorkflowLogItem: type: object properties: id: type: string format: uuid description: ログエントリ ID です。 workflow_run: $ref: '#/components/schemas/WorkflowRunSummary' created_from: type: string description: ワークフロー実行のソース（例：`service-api`）です。 created_by_role: type: string description: 作成者のロール（例：`end_user`、`account`）です。 created_by_account: type: object nullable: true description: 管理者ユーザーが作成した場合のアカウント詳細です。 properties: id: type: string format: uuid description: アカウント ID。 name: type: string description: アカウント表示名。 email: type: string description: アカウントメールアドレス。 created_by_end_user: $ref: '#/components/schemas/EndUserSummary' created_at: type: integer format: int64 description: ログエントリが作成された Unix タイムスタンプです。 details: type: object additionalProperties: true nullable: true description: ログエントリの追加詳細です。 WorkflowRunSummary: type: object properties: id: type: string format: uuid description: ワークフロー実行 ID です。 version: type: string description: ワークフローバージョン識別子です。 status: type: string description: >- ワークフローの実行ステータスです。`running` は実行中、`succeeded` は正常完了、`failed` は実行エラー、`stopped` は手動停止、`partial-succeeded` は一部のノードが成功し他が失敗、`paused` は人間の入力待ちを示します。 error: type: string nullable: true description: ワークフローが失敗した場合のエラーメッセージです。 elapsed_time: type: number format: float description: 合計経過時間（秒）です。 total_tokens: type: integer description: 消費された合計トークン数です。 total_steps: type: integer description: 実行されたワークフローの合計ステップ数です。 created_at: type: integer format: int64 description: ワークフロー実行が作成された Unix タイムスタンプです。 finished_at: type: integer format: int64 nullable: true description: ワークフロー実行が完了した Unix タイムスタンプです。 exceptions_count: type: integer description: 実行中に発生した例外の数です。 triggered_from: type: string description: >- ワークフロー実行をトリガーしたソースです。`debugging` はエディタからのテスト実行、`app` は API またはアプリからの実行を示します。 EndUserSummary: type: object properties: id: type: string format: uuid description: エンドユーザー ID。 type: type: string description: エンドユーザーの種類です。 is_anonymous: type: boolean description: エンドユーザーが匿名かどうかです。 session_id: type: string description: セッション識別子です。 securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API_KEY description: >- API Key 認証です。すべての API リクエストにおいて、`Authorization` HTTP ヘッダーに `Bearer ` プレフィックスを付けた API Key を含めてください。例：`Authorization: Bearer {API_KEY}`。**API Key はサーバーサイドに保存し、クライアントサイドで共有・保存しないことを強く推奨します。API Key の漏洩は深刻な結果につながる可能性があります。** ````