> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List conversation runs

> List canonical runs in a readable conversation, using the target cursor and response contract.

export const McpToolCall = ({tool, initialArguments = {}, requiresConfirmation = false}) => {
  const validateCall = function validateReferenceToolCall(token, text, requiresConfirmation, confirmed) {
    if (!token.trim()) return {
      error: "Paste a bearer token first."
    };
    let value;
    try {
      value = JSON.parse(text.trim() || "{}");
    } catch {
      return {
        error: "Arguments must be valid JSON."
      };
    }
    if (!value || typeof value !== "object" || Array.isArray(value)) return {
      error: "Arguments must be a JSON object."
    };
    if (requiresConfirmation && !confirmed) return {
      error: "Confirm the tool call before running it."
    };
    return {
      arguments: value
    };
  };
  const endpoint = "https://api.veryfront.com/mcp";
  const tokenStorageKey = 'veryfront.docs.mcpBearerToken';
  const escapeHtml = value => value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
  const highlightJson = value => {
    const escaped = escapeHtml(value);
    return escaped.replace(/("(?:\\u[a-fA-F0-9]{4}|\\[^u]|[^\\"])*"(\s*:)?|\btrue\b|\bfalse\b|\bnull\b|-?\d+(?:\.\d+)?(?:[eE][+\-]?\d+)?)/g, match => {
      let color = '#f3f4f6';
      if (match.endsWith(':')) {
        color = '#7dd3fc';
      } else if (match.startsWith('"')) {
        color = '#86efac';
      } else if ((/true|false/).test(match)) {
        color = '#c4b5fd';
      } else if ((/null/).test(match)) {
        color = '#fcd34d';
      } else {
        color = '#67e8f9';
      }
      return `<span style="color: ${color}">${match}</span>`;
    });
  };
  const expandJsonStrings = value => {
    if (typeof value === 'string') {
      const trimmed = value.trim();
      if (trimmed.startsWith('{') && trimmed.endsWith('}') || trimmed.startsWith('[') && trimmed.endsWith(']')) {
        try {
          return expandJsonStrings(JSON.parse(trimmed));
        } catch {}
      }
      return value;
    }
    if (Array.isArray(value)) {
      return value.map(expandJsonStrings);
    }
    if (value && typeof value === 'object') {
      return Object.fromEntries(Object.entries(value).map(([key, nestedValue]) => [key, expandJsonStrings(nestedValue)]));
    }
    return value;
  };
  const formatJson = value => {
    try {
      return JSON.stringify(expandJsonStrings(value), null, 2);
    } catch {
      return String(value);
    }
  };
  const formatResponseText = text => {
    const trimmed = text.trim();
    if (!trimmed) return 'No response body.';
    try {
      return formatJson(JSON.parse(trimmed));
    } catch {}
    const ssePayloads = trimmed.split(/\n\n+/).flatMap(chunk => chunk.split('\n').filter(line => line.startsWith('data:')).map(line => line.slice(5).trim()).filter(Boolean));
    for (let index = ssePayloads.length - 1; index >= 0; index -= 1) {
      try {
        return formatJson(JSON.parse(ssePayloads[index]));
      } catch {}
    }
    return trimmed;
  };
  const readStoredToken = () => {
    if (typeof window === 'undefined') return '';
    try {
      return window.sessionStorage.getItem(tokenStorageKey) || '';
    } catch {
      return '';
    }
  };
  const writeStoredToken = value => {
    if (typeof window === 'undefined') return;
    try {
      if (value) {
        window.sessionStorage.setItem(tokenStorageKey, value);
      } else {
        window.sessionStorage.removeItem(tokenStorageKey);
      }
    } catch {}
  };
  const [token, setToken] = useState(readStoredToken);
  const [argumentText, setArgumentText] = useState(formatJson(initialArguments));
  const [status, setStatus] = useState('Ready');
  const [response, setResponse] = useState('No response yet.');
  const [copied, setCopied] = useState(false);
  const [confirmed, setConfirmed] = useState(false);
  const callTool = async () => {
    const validation = validateCall(token, argumentText, requiresConfirmation, confirmed);
    if (('error' in validation)) {
      setStatus(validation.error);
      return;
    }
    const parsedArguments = validation.arguments;
    setConfirmed(false);
    const body = {
      jsonrpc: '2.0',
      id: Date.now(),
      method: 'tools/call',
      params: {
        name: tool,
        arguments: parsedArguments
      }
    };
    setStatus('Calling tool...');
    setResponse(formatJson(body));
    try {
      const result = await fetch(endpoint, {
        method: 'POST',
        headers: {
          accept: 'application/json, text/event-stream',
          'content-type': 'application/json',
          authorization: `Bearer ${token.trim()}`,
          'x-veryfront-origin': 'docs-mcp-tool-page'
        },
        body: JSON.stringify(body)
      });
      const text = await result.text();
      setStatus(result.ok ? 'Response received.' : `Request failed with HTTP ${result.status}.`);
      setResponse(formatResponseText(text));
    } catch (error) {
      setStatus('Request failed.');
      setResponse(error instanceof Error ? error.message : String(error));
    }
  };
  const copyResponse = async () => {
    try {
      await navigator.clipboard.writeText(response);
      setCopied(true);
      setTimeout(() => setCopied(false), 1500);
    } catch {
      setStatus('Copy failed.');
    }
  };
  return <details className="api-try-operation not-prose">
    <summary>Try this tool</summary>
    <p>Replace sample arguments with values for your project or connected account. Calls run only when you select Run tool.</p>
    <div className="api-request-playground not-prose my-6 rounded-xl border border-gray-200 bg-white p-4 dark:border-gray-800 dark:bg-gray-950">
      <div className="mb-4">
        <div className="text-sm font-semibold text-gray-900 dark:text-gray-100">MCP tool call</div>
        <div className="mt-1 text-sm text-gray-600 dark:text-gray-400">
          Call <code>{tool}</code> against the Veryfront MCP endpoint.
        </div>
      </div>

      <label className="mb-2 block text-sm font-medium text-gray-900 dark:text-gray-100" htmlFor={`${tool}-token`}>
        Bearer token or API key
      </label>
      <input id={`${tool}-token`} className="mb-4 w-full rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100" type="password" value={token} onChange={event => {
    const value = event.target.value;
    setToken(value);
    setConfirmed(false);
    writeStoredToken(value);
  }} placeholder="Paste API key or JWT" />

      <label className="mb-2 block text-sm font-medium text-gray-900 dark:text-gray-100" htmlFor={`${tool}-arguments`}>
        Arguments (JSON)
      </label>
      <textarea id={`${tool}-arguments`} className="mb-4 min-h-40 w-full rounded-md border border-gray-300 bg-white px-3 py-2 font-mono text-sm text-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100" value={argumentText} onChange={event => {
    setArgumentText(event.target.value);
    setConfirmed(false);
  }} spellCheck={false} />

      {requiresConfirmation && <label className="api-request-confirmation mb-4 flex items-start gap-2 text-sm">
        <input type="checkbox" checked={confirmed} onChange={event => setConfirmed(event.target.checked)} />
        <span>{tool === 'veryfront__set_project_inference_policy' ? 'Replace the project inference policy with these arguments. Omitted constraints will be removed.' : 'Run this tool with these arguments.'}</span>
      </label>}
      <button disabled={status === 'Calling tool...' || requiresConfirmation && !confirmed} className="disabled:opacity-50 disabled:cursor-not-allowed rounded-md bg-gray-900 px-3 py-2 text-sm font-medium text-white hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-950 dark:hover:bg-gray-300" type="button" onClick={callTool}>
        Run tool
      </button>

      <div className="mt-4 text-sm font-medium text-gray-900 dark:text-gray-100">{status}</div>
      <div className="mt-3 overflow-hidden rounded-md border border-gray-300 dark:border-gray-700">
        <div className="flex items-center justify-between bg-gray-100 px-3 py-2 text-sm font-medium text-gray-900 dark:bg-gray-900 dark:text-gray-100">
          <span>Output JSON</span>
          <button className="rounded border border-gray-300 bg-white px-2 py-1 text-xs text-gray-900 hover:bg-gray-50 dark:border-gray-700 dark:bg-gray-950 dark:text-gray-100 dark:hover:bg-gray-800" type="button" onClick={copyResponse}>
            {copied ? 'Copied' : 'Copy'}
          </button>
        </div>
      <pre className="max-h-96 overflow-auto whitespace-pre-wrap break-words bg-gray-950 p-4 text-sm text-gray-100">
        <code dangerouslySetInnerHTML={{
    __html: highlightJson(response)
  }} />
      </pre>
      </div>
    </div>
    </details>;
};

<div className="api-operation-signature">
  `veryfront__list_conversation_runs`
</div>

## Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

**Call type:** Read-only.

## Arguments

| Field | Type | Required | Description and constraints |
| - | - | - | - |
| `conversation_id` | `string` | Yes | Conversation identifier that scopes the request. Format: `uuid`. |
| `cursor` | `string` | No | Opaque pagination cursor returned by a previous response. |
| `limit` | `integer` | No | Maximum number of results to return. Default: `20`. Minimum: `1`. Maximum: `100`. |
| `status` | `string[]` | No | Lifecycle status for the target record. |

## Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See [MCP client setup](/docs/cloud/getting-started/connect-mcp).

```json title="request.json" theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__list_conversation_runs",
    "arguments": {
      "conversation_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}
```

## Result

The published output shape is summarized below. Inspect both the MCP response content and `isError` when handling a call.

| Field | Type | Required | Description and constraints |
| - | - | - | - |
| `data` | `object[]` | Yes | Primary result records returned by the tool. |
| `page_info` | `object` | Yes | Opaque cursor for the next page; null means there are no more results. |

## Full schemas

<CodeGroup>
  ```json title="input-schema.json" theme={null}
  {
    "type": "object",
    "properties": {
      "conversation_id": {
        "type": "string",
        "format": "uuid",
        "description": "Conversation identifier that scopes the request."
      },
      "cursor": {
        "type": "string",
        "description": "Opaque pagination cursor returned by a previous response."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "default": 20,
        "description": "Maximum number of results to return."
      },
      "status": {
        "type": "array",
        "items": {
          "type": "string",
          "description": "One statu item supplied to the tool."
        },
        "maxItems": 32,
        "description": "Lifecycle status for the target record."
      }
    },
    "required": [
      "conversation_id"
    ],
    "additionalProperties": false,
    "$schema": "http://json-schema.org/draft-07/schema#",
    "description": "Arguments for the list_conversation_runs tool."
  }
  ```

  ```json title="output-schema.json" theme={null}
  {
    "type": "object",
    "properties": {
      "data": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid",
              "description": "Unique run UUID."
            },
            "status": {
              "type": "string",
              "enum": [
                "pending",
                "running",
                "waiting",
                "completed",
                "failed",
                "cancelled"
              ],
              "description": "Current execution state."
            },
            "project_id": {
              "type": "string",
              "format": "uuid",
              "description": "Project containing the run."
            },
            "target": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "agent",
                    "task",
                    "workflow",
                    "eval"
                  ],
                  "description": "The type returned by the tool."
                },
                "id": {
                  "anyOf": [
                    {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 512,
                      "pattern": "^\\S+$",
                      "description": "Unique identifier for the returned record."
                    },
                    {
                      "type": "null",
                      "description": "Unique identifier for the returned record."
                    }
                  ],
                  "description": "Unique identifier for the returned record."
                }
              },
              "required": [
                "type",
                "id"
              ],
              "additionalProperties": false,
              "description": "Recorded execution definition; historical IDs may be unavailable."
            },
            "input": {
              "description": "Business input supplied when the run was created."
            },
            "output": {
              "$ref": "#/properties/data/items/properties/input",
              "description": "Final business output; null until successful finalization."
            },
            "error": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Provide the code."
                },
                "message": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4000,
                  "description": "Provide the message."
                },
                "details": {
                  "type": "object",
                  "additionalProperties": {
                    "$ref": "#/properties/data/items/properties/input",
                    "description": "Any JSON value. The HTTP boundary rejects non-JSON values."
                  },
                  "description": "Provide the details."
                }
              },
              "required": [
                "code",
                "message"
              ],
              "additionalProperties": false,
              "description": "Error details returned by the tool."
            },
            "title": {
              "type": "string",
              "description": "Display title, omitted when unset."
            },
            "labels": {
              "type": "object",
              "additionalProperties": {
                "type": "string",
                "maxLength": 256,
                "description": "Additional structured values returned by the tool."
              },
              "description": "Structured labels details returned by the tool."
            },
            "parent_run_id": {
              "type": "string",
              "format": "uuid",
              "description": "Immediate parent run ID, present on child runs."
            },
            "root_run_id": {
              "type": "string",
              "format": "uuid",
              "description": "Top-level ancestor run ID, present on child runs."
            },
            "created_at": {
              "type": "string",
              "format": "date-time",
              "description": "When the run was accepted."
            },
            "updated_at": {
              "type": "string",
              "format": "date-time",
              "description": "When the resource last changed, including usage updates."
            },
            "started_at": {
              "type": "string",
              "format": "date-time",
              "description": "When the first execution attempt started, omitted before execution."
            },
            "finished_at": {
              "type": "string",
              "format": "date-time",
              "description": "When the run completed, failed or was cancelled."
            },
            "config": {
              "type": "object",
              "additionalProperties": {
                "$ref": "#/properties/data/items/properties/input",
                "description": "A JSON value."
              },
              "description": "Definition-specific execution configuration."
            },
            "execution": {
              "type": "object",
              "properties": {
                "runtime": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "main_branch"
                          ],
                          "description": "The type returned by the tool."
                        }
                      },
                      "required": [
                        "type"
                      ],
                      "additionalProperties": false,
                      "description": "Structured runtime details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "environment"
                          ],
                          "description": "The type returned by the tool."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier for the returned record."
                        }
                      },
                      "required": [
                        "type",
                        "id"
                      ],
                      "additionalProperties": false,
                      "description": "Structured runtime details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "preview_branch"
                          ],
                          "description": "The type returned by the tool."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "description": "Unique identifier for the returned record."
                        }
                      },
                      "required": [
                        "type",
                        "id"
                      ],
                      "additionalProperties": false,
                      "description": "Structured runtime details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "registered"
                          ],
                          "description": "The type returned by the tool."
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "Unique identifier for the returned record."
                        }
                      },
                      "required": [
                        "type",
                        "id"
                      ],
                      "additionalProperties": false,
                      "description": "Structured runtime details returned by the tool."
                    }
                  ],
                  "description": "Select an authorized deployment or registered runtime; omit to use the definition default."
                },
                "timeout_seconds": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "description": "The timeout seconds returned by the tool."
                },
                "retry_limit": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "The retry limit returned by the tool."
                },
                "attempt": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "Current or last execution attempt, starting at 1; absent before execution."
                },
                "exit_code": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "description": "The exit code returned by the tool."
                    },
                    {
                      "type": "null",
                      "description": "The exit code returned by the tool."
                    }
                  ],
                  "description": "The exit code returned by the tool."
                },
                "duration_ms": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0,
                      "description": "The duration ms returned by the tool."
                    },
                    {
                      "type": "null",
                      "description": "The duration ms returned by the tool."
                    }
                  ],
                  "description": "Elapsed time from first start to finish, including waits and retries; null when not finished."
                },
                "tool_error_count": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "The tool error count returned by the tool."
                },
                "logs": {
                  "type": "string",
                  "description": "The logs returned by the tool."
                },
                "start_mode": {
                  "type": "string",
                  "description": "Recorded execution start mode, when available."
                }
              },
              "additionalProperties": false,
              "description": "Resolved execution settings and diagnostics."
            },
            "control": {
              "type": "object",
              "properties": {
                "waiting": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "manual_pause"
                          ],
                          "description": "The reason returned by the tool."
                        }
                      },
                      "required": [
                        "reason"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "tool_result"
                          ],
                          "description": "The reason returned by the tool."
                        },
                        "tool_call_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "Tool call identifier associated with this result."
                        }
                      },
                      "required": [
                        "reason",
                        "tool_call_id"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "integration_connected"
                          ],
                          "description": "The reason returned by the tool."
                        },
                        "integration": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "The integration returned by the tool."
                        }
                      },
                      "required": [
                        "reason",
                        "integration"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "approval"
                          ],
                          "description": "The reason returned by the tool."
                        },
                        "wait_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "The wait id returned by the tool."
                        },
                        "node_ids": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 128,
                            "description": "One node id item returned by the tool."
                          },
                          "minItems": 1,
                          "description": "List of node ids returned by the tool."
                        }
                      },
                      "required": [
                        "reason",
                        "wait_id",
                        "node_ids"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "event"
                          ],
                          "description": "The reason returned by the tool."
                        },
                        "wait_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "The wait id returned by the tool."
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "Human-readable name for the returned record."
                        }
                      },
                      "required": [
                        "reason",
                        "wait_id",
                        "name"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "input_request"
                          ],
                          "description": "The reason returned by the tool."
                        },
                        "input_request_ids": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "format": "uuid",
                            "description": "One input request id item returned by the tool."
                          },
                          "minItems": 1,
                          "description": "List of input request ids returned by the tool."
                        }
                      },
                      "required": [
                        "reason",
                        "input_request_ids"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "child_run"
                          ],
                          "description": "The reason returned by the tool."
                        },
                        "dependencies": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "run_id": {
                                "type": "string",
                                "format": "uuid",
                                "description": "Run identifier associated with this result."
                              },
                              "correlation": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "enum": [
                                          "tool_call"
                                        ],
                                        "description": "The type returned by the tool."
                                      },
                                      "id": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 128,
                                        "description": "Unique identifier for the returned record."
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "id"
                                    ],
                                    "additionalProperties": false,
                                    "description": "Structured correlation details returned by the tool."
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "enum": [
                                          "workflow_node"
                                        ],
                                        "description": "The type returned by the tool."
                                      },
                                      "id": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 128,
                                        "description": "Unique identifier for the returned record."
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "id"
                                    ],
                                    "additionalProperties": false,
                                    "description": "Structured correlation details returned by the tool."
                                  }
                                ],
                                "description": "The correlation returned by the tool."
                              }
                            },
                            "required": [
                              "run_id",
                              "correlation"
                            ],
                            "additionalProperties": false,
                            "description": "One dependency item returned by the tool."
                          },
                          "minItems": 1,
                          "description": "List of dependencies returned by the tool."
                        }
                      },
                      "required": [
                        "reason",
                        "dependencies"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    },
                    {
                      "type": "object",
                      "properties": {
                        "resume_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "The resume at returned by the tool."
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "timer"
                          ],
                          "description": "The reason returned by the tool."
                        }
                      },
                      "required": [
                        "resume_at",
                        "reason"
                      ],
                      "additionalProperties": false,
                      "description": "Structured waiting details returned by the tool."
                    }
                  ],
                  "description": "The current durable wait, with only the fields required to satisfy that wait."
                },
                "pause": {
                  "type": "object",
                  "properties": {
                    "requested_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "The requested at returned by the tool."
                    }
                  },
                  "required": [
                    "requested_at"
                  ],
                  "additionalProperties": false,
                  "description": "When a pause was requested; control.waiting confirms when execution is paused."
                },
                "cancellation": {
                  "type": "object",
                  "properties": {
                    "requested_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "The requested at returned by the tool."
                    },
                    "stopped_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "description": "The stopped at returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The stopped at returned by the tool."
                        }
                      ],
                      "description": "The stopped at returned by the tool."
                    }
                  },
                  "required": [
                    "requested_at",
                    "stopped_at"
                  ],
                  "additionalProperties": false,
                  "description": "Structured cancellation details returned by the tool."
                }
              },
              "additionalProperties": false,
              "description": "Pending control requests and the current wait."
            },
            "task_id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200,
              "description": "Orchestration task ID, distinct from the execution definition."
            },
            "conversation_id": {
              "type": "string",
              "format": "uuid",
              "description": "Conversation containing the run."
            },
            "input_message_id": {
              "type": "string",
              "format": "uuid",
              "description": "Conversation message that supplied the input."
            },
            "output_message_id": {
              "type": "string",
              "format": "uuid",
              "description": "Conversation message containing the result."
            },
            "batch_id": {
              "type": "string",
              "format": "uuid",
              "description": "Batch containing the run."
            },
            "trigger": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "user"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "description": "Unique identifier for the returned record."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "api_key"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "Unique identifier for the returned record."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "service_account"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "Unique identifier for the returned record."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "system"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "Unique identifier for the returned record."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "schedule"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "description": "Unique identifier for the returned record."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "webhook"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "Unique identifier for the returned record."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "agent"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 512,
                      "pattern": "^\\S+$",
                      "description": "Unique identifier for the returned record."
                    },
                    "tool_call_id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "Tool call identifier associated with this result."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "task"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 512,
                      "pattern": "^\\S+$",
                      "description": "Unique identifier for the returned record."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "workflow"
                      ],
                      "description": "The type returned by the tool."
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 512,
                      "pattern": "^\\S+$",
                      "description": "Unique identifier for the returned record."
                    },
                    "node_id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "The node id returned by the tool."
                    }
                  },
                  "required": [
                    "type",
                    "id"
                  ],
                  "additionalProperties": false,
                  "description": "Structured trigger details returned by the tool."
                }
              ],
              "description": "User, credential, automation or execution definition that directly started this run."
            },
            "usage": {
              "type": "object",
              "properties": {
                "tokens": {
                  "type": "object",
                  "properties": {
                    "input": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0,
                          "description": "The input returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The input returned by the tool."
                        }
                      ],
                      "description": "The input returned by the tool."
                    },
                    "output": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0,
                          "description": "The output returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The output returned by the tool."
                        }
                      ],
                      "description": "The output returned by the tool."
                    },
                    "cache": {
                      "type": "object",
                      "properties": {
                        "read": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "description": "The read returned by the tool."
                            },
                            {
                              "type": "null",
                              "description": "The read returned by the tool."
                            }
                          ],
                          "description": "The read returned by the tool."
                        },
                        "write": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "description": "The write returned by the tool."
                            },
                            {
                              "type": "null",
                              "description": "The write returned by the tool."
                            }
                          ],
                          "description": "The write returned by the tool."
                        }
                      },
                      "required": [
                        "read",
                        "write"
                      ],
                      "additionalProperties": false,
                      "description": "Structured cache details returned by the tool."
                    },
                    "reasoning": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0,
                          "description": "The reasoning returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The reasoning returned by the tool."
                        }
                      ],
                      "description": "The reasoning returned by the tool."
                    },
                    "total": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0,
                          "description": "The total returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The total returned by the tool."
                        }
                      ],
                      "description": "The total returned by the tool."
                    }
                  },
                  "required": [
                    "input",
                    "output",
                    "cache",
                    "total"
                  ],
                  "additionalProperties": false,
                  "description": "Input excludes cache reads/writes; output includes reasoning. Total is input + output + cache.read + cache.write. Null means unknown, never zero."
                },
                "cost": {
                  "type": "object",
                  "properties": {
                    "currency": {
                      "type": "string",
                      "enum": [
                        "EUR"
                      ],
                      "description": "The currency returned by the tool."
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "estimated",
                        "posted",
                        "unavailable"
                      ],
                      "description": "Lifecycle status for the returned record."
                    },
                    "provider": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^-?\\d+(\\.\\d{1,8})?$",
                          "description": "The provider returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The provider returned by the tool."
                        }
                      ],
                      "description": "The provider returned by the tool."
                    },
                    "platform": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^-?\\d+(\\.\\d{1,8})?$",
                          "description": "The platform returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The platform returned by the tool."
                        }
                      ],
                      "description": "The platform returned by the tool."
                    },
                    "total": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^-?\\d+(\\.\\d{1,8})?$",
                          "description": "The total returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The total returned by the tool."
                        }
                      ],
                      "description": "The total returned by the tool."
                    },
                    "credits": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^-?\\d+(\\.\\d{1,8})?$",
                          "description": "The credits returned by the tool."
                        },
                        {
                          "type": "null",
                          "description": "The credits returned by the tool."
                        }
                      ],
                      "description": "The credits returned by the tool."
                    }
                  },
                  "required": [
                    "currency",
                    "status",
                    "provider",
                    "platform",
                    "total",
                    "credits"
                  ],
                  "additionalProperties": false,
                  "description": "Provider and platform charges in EUR before tax; total is their sum when known. Credits are billed units, not a currency or a fixed EUR conversion. Signed decimal strings have at most eight fractional digits. Negative amounts are billing adjustments. Status is independent of token capture; unavailable requires all amounts null. Posted amounts come from the billing ledger and may change through later adjustments."
                },
                "model_calls": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0,
                      "description": "The model calls returned by the tool."
                    },
                    {
                      "type": "null",
                      "description": "The model calls returned by the tool."
                    }
                  ],
                  "description": "The model calls returned by the tool."
                },
                "capture_status": {
                  "type": "string",
                  "enum": [
                    "complete",
                    "partial",
                    "missing"
                  ],
                  "description": "The capture status returned by the tool."
                }
              },
              "required": [
                "tokens",
                "cost",
                "capture_status"
              ],
              "additionalProperties": false,
              "description": "Shared usage shape for a run, descendant aggregate, or evaluation; capture_status describes token capture coverage. Cost can remain unavailable independently."
            },
            "descendants": {
              "type": "object",
              "properties": {
                "total": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Total descendants at every depth."
                },
                "active": {
                  "type": "integer",
                  "minimum": 0,
                  "description": "Descendants that are pending, running or waiting."
                },
                "has_failures": {
                  "type": "boolean",
                  "description": "Whether any descendant has failed."
                },
                "usage": {
                  "$ref": "#/properties/data/items/properties/usage",
                  "description": "Shared usage shape for a run, descendant aggregate, or evaluation; capture_status describes token capture coverage. Cost can remain unavailable independently."
                }
              },
              "required": [
                "total",
                "active",
                "has_failures"
              ],
              "additionalProperties": false,
              "description": "Counts and usage across all descendant runs, excluding this run."
            },
            "artifacts": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "artifact_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128,
                    "description": "The artifact id returned by the tool."
                  },
                  "type": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The type returned by the tool."
                  },
                  "media_type": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The media type returned by the tool."
                  },
                  "size_bytes": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "The size bytes returned by the tool."
                  },
                  "sha256": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$",
                    "description": "The sha256 returned by the tool."
                  },
                  "href": {
                    "type": "string",
                    "format": "uri",
                    "description": "The href returned by the tool."
                  }
                },
                "required": [
                  "artifact_id",
                  "type",
                  "media_type",
                  "size_bytes",
                  "sha256",
                  "href"
                ],
                "additionalProperties": false,
                "description": "An immutable file reference authorized through the run’s project and conversation permissions."
              },
              "description": "Files produced by the run."
            },
            "schemas": {
              "type": "object",
              "properties": {
                "input": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "schema": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "description": "The schema returned by the tool."
                            },
                            {
                              "type": "object",
                              "additionalProperties": {
                                "$ref": "#/properties/data/items/properties/input",
                                "description": "A JSON value."
                              },
                              "description": "Structured schema details returned by the tool."
                            }
                          ],
                          "description": "The schema returned by the tool."
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$",
                          "description": "The sha256 returned by the tool."
                        }
                      },
                      "required": [
                        "schema",
                        "sha256"
                      ],
                      "additionalProperties": false,
                      "description": "Structured input details returned by the tool."
                    },
                    {
                      "type": "null",
                      "description": "The input returned by the tool."
                    }
                  ],
                  "description": "The input returned by the tool."
                },
                "output": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "schema": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "description": "The schema returned by the tool."
                            },
                            {
                              "type": "object",
                              "additionalProperties": {
                                "$ref": "#/properties/data/items/properties/input",
                                "description": "A JSON value."
                              },
                              "description": "Structured schema details returned by the tool."
                            }
                          ],
                          "description": "The schema returned by the tool."
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$",
                          "description": "The sha256 returned by the tool."
                        }
                      },
                      "required": [
                        "schema",
                        "sha256"
                      ],
                      "additionalProperties": false,
                      "description": "Structured output details returned by the tool."
                    },
                    {
                      "type": "null",
                      "description": "The output returned by the tool."
                    }
                  ],
                  "description": "The output returned by the tool."
                }
              },
              "required": [
                "input",
                "output"
              ],
              "additionalProperties": false,
              "description": "Pinned schemas for business input and output; null means no declared schema."
            },
            "metadata": {
              "type": "object",
              "additionalProperties": {
                "$ref": "#/properties/data/items/properties/input",
                "description": "A JSON value."
              },
              "description": "Additional resource metadata."
            }
          },
          "required": [
            "id",
            "status",
            "project_id",
            "target",
            "input",
            "output",
            "created_at",
            "updated_at"
          ],
          "additionalProperties": false,
          "description": "One execution resource returned by reads, creation, updates, and lifecycle actions. Omit irrelevant fields and empty groups. Errors appear only on failure; parent/root IDs only on child runs; timestamps appear when reached. Output is null until successful finalization."
        },
        "description": "Primary result records returned by the tool."
      },
      "page_info": {
        "type": "object",
        "properties": {
          "next": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cursor for the next page when pagination is available."
          }
        },
        "required": [
          "next"
        ],
        "additionalProperties": false,
        "description": "Opaque cursor for the next page; null means there are no more results."
      }
    },
    "required": [
      "data",
      "page_info"
    ],
    "additionalProperties": false,
    "$schema": "http://json-schema.org/draft-07/schema#",
    "description": "Structured result returned by the list_conversation_runs tool."
  }
  ```
</CodeGroup>

<McpToolCall
  tool="veryfront__list_conversation_runs"
  initialArguments={{
"conversation_id": "00000000-0000-4000-8000-000000000000"
}}
/>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.