veryfront__list_run_input_requestspage_info.next as cursor for the next page.
Requires viewer access to the resource that owns the run.
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 |
|---|---|---|---|
run_id | string | Yes | Public run id, as returned by REST GET /runs/{run_id}. Minimum length: 1. Maximum length: 255. |
status | string | No | Only requests in this status: open, submitted, cancelled or expired. |
limit | integer | No | Page size, 1-100 (default 20). |
cursor | string | No | The previous page’s page_info.next. |
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.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__list_run_input_requests",
"arguments": {
"run_id": "example"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data | object[] | Yes | Primary result records returned by the tool. |
page_info | object | Yes | Pagination cursor values for traversing the result set. |
Full schemas
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Public run id, as returned by REST GET /runs/{run_id}."
},
"status": {
"type": "string",
"description": "Only requests in this status: open, submitted, cancelled or expired."
},
"limit": {
"type": "integer",
"description": "Page size, 1-100 (default 20)."
},
"cursor": {
"type": "string",
"description": "The previous page's page_info.next."
}
},
"required": [
"run_id"
],
"additionalProperties": false,
"description": "Arguments for the list_run_input_requests tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for the returned record."
},
"conversation_id": {
"anyOf": [
{
"$ref": "#/properties/data/items/properties/id",
"description": "Conversation identifier associated with this result."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Conversation identifier associated with this result."
},
"run_id": {
"type": "string",
"description": "Run identifier associated with this result."
},
"tool_call_id": {
"type": "string",
"description": "Tool call identifier associated with this result."
},
"kind": {
"type": "string",
"const": "form"
},
"status": {
"type": "string",
"enum": [
"open",
"submitted",
"cancelled",
"expired"
],
"description": "Lifecycle status for the returned record."
},
"requested_responder_type": {
"type": "string",
"enum": [
"human",
"agent",
"system"
]
},
"title": {
"type": "string",
"description": "Short human-readable title returned by the tool."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description returned by the tool."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "Fields returned for the structured input request."
},
"recommendations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Suggested values or defaults returned by the tool."
},
{
"type": "null",
"description": "Suggested values or defaults returned by the tool."
}
],
"description": "Suggested values or defaults returned by the tool."
},
"metadata": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Additional structured metadata returned by the tool."
},
{
"type": "null",
"description": "Additional structured metadata returned by the tool."
}
],
"description": "Additional structured metadata returned by the tool."
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
},
"expires_at": {
"type": [
"string",
"null"
]
},
"submitted_at": {
"type": [
"string",
"null"
],
"description": "Submission timestamp in ISO 8601 format."
},
"cancelled_at": {
"type": [
"string",
"null"
]
},
"expired_at": {
"type": [
"string",
"null"
]
},
"latest_response": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"$ref": "#/properties/data/items/properties/id",
"description": "Unique identifier for the returned record."
},
"input_request_id": {
"$ref": "#/properties/data/items/properties/id",
"description": "The input request id returned by the tool."
},
"conversation_id": {
"anyOf": [
{
"$ref": "#/properties/data/items/properties/id",
"description": "Conversation identifier associated with this result."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Conversation identifier associated with this result."
},
"run_id": {
"type": "string",
"description": "Run identifier associated with this result."
},
"actor_type": {
"type": "string",
"enum": [
"human",
"agent",
"system",
"integration"
],
"description": "Type of actor associated with this result."
},
"actor_id": {
"type": "string",
"description": "Identifier for the actor associated with this result."
},
"values": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"boolean",
"number",
"null"
],
"description": "Additional structured values supplied to the tool."
},
"description": "Structured values submitted to the tool."
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
}
},
"required": [
"id",
"input_request_id",
"conversation_id",
"run_id",
"actor_type",
"actor_id",
"values",
"created_at"
],
"additionalProperties": false,
"description": "Structured latest response details associated with this tool result."
},
{
"type": "null",
"description": "The latest response returned by the tool."
}
]
}
},
"required": [
"id",
"conversation_id",
"run_id",
"tool_call_id",
"kind",
"status",
"requested_responder_type",
"title",
"description",
"fields",
"recommendations",
"metadata",
"created_at",
"expires_at",
"submitted_at",
"cancelled_at",
"expired_at"
],
"additionalProperties": false
},
"description": "Primary result records returned by the tool."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor that refers to the current page."
},
"first": {
"type": "null"
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page when pagination is available."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page when pagination is available."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursor values for traversing the result set."
}
},
"required": [
"data",
"page_info"
],
"additionalProperties": false,
"description": "Structured result returned by the list_run_input_requests tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}