veryfront__list_input_requestsAccess
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. |
status | string | No | Lifecycle status for the target record. Values: "open", "submitted", "cancelled", "expired". |
run_id | string | No | Run identifier that scopes the request. Minimum length: 1. Maximum length: 255. |
cursor | string | No | Opaque pagination cursor returned by a previous response. |
limit | integer | No | Maximum number of results to return. Minimum: 1. Maximum: 100. |
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_input_requests",
"arguments": {
"conversation_id": "00000000-0000-4000-8000-000000000000"
}
}
}
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 | Input requests for the requested page. |
page_info | object | Yes | Pagination cursors for the input request list. |
Full schemas
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"format": "uuid",
"description": "Conversation identifier that scopes the request."
},
"status": {
"type": "string",
"enum": [
"open",
"submitted",
"cancelled",
"expired"
],
"description": "Lifecycle status for the target record."
},
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Run identifier that scopes the request."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor returned by a previous response."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum number of results to return."
}
},
"required": [
"conversation_id"
],
"additionalProperties": false,
"description": "Arguments for the list_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": "Input request identifier."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Conversation identifier that owns the request, or null when the request belongs only to a run."
},
"run_id": {
"type": "string",
"description": "Agent run identifier waiting on this request."
},
"tool_call_id": {
"type": "string",
"description": "Tool call identifier that triggered the request."
},
"kind": {
"type": "string",
"description": "Input request interaction type."
},
"status": {
"type": "string",
"description": "Lifecycle status of the request."
},
"requested_responder_type": {
"type": "string",
"description": "Responder type expected to answer the request."
},
"title": {
"type": "string",
"description": "Short prompt shown to the responder."
},
"description": {
"type": [
"string",
"null"
],
"description": "Long-form guidance explaining the requested input."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "One field item associated with this record."
},
"description": "Field definitions that the responder must complete."
},
"recommendations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Suggested values or defaults associated with the record."
},
{
"type": "null",
"description": "Suggested values or defaults returned by the tool."
}
],
"description": "Suggested values or defaults for the responder."
},
"metadata": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Additional structured metadata for the record."
},
{
"type": "null",
"description": "Additional structured metadata returned by the tool."
}
],
"description": "Additional machine-readable metadata for rendering or orchestration."
},
"created_at": {
"type": "string",
"description": "Timestamp when the request was created."
},
"expires_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when the request expires, or null when it does not expire."
},
"submitted_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when a response was submitted."
},
"cancelled_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when the request was cancelled."
},
"expired_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when the request expired."
},
"latest_response": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Input response identifier."
},
"input_request_id": {
"type": "string",
"format": "uuid",
"description": "Input request identifier that this response answers."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Conversation identifier associated with the request and response, or null for a headless run."
},
"run_id": {
"type": "string",
"description": "Agent run identifier that is waiting for or consumed this response."
},
"actor_type": {
"type": "string",
"description": "Actor type that submitted the response, such as human or agent."
},
"actor_id": {
"type": "string",
"description": "Actor identifier that submitted the response."
},
"values": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number",
"boolean",
"null"
],
"description": "Additional structured values associated with this result."
},
"description": "Submitted field values keyed by input request field name."
},
"created_at": {
"type": "string",
"description": "Timestamp when the response was created."
}
},
"required": [
"id",
"input_request_id",
"conversation_id",
"run_id",
"actor_type",
"actor_id",
"values",
"created_at"
],
"additionalProperties": false,
"description": "Submitted response to a structured input request."
},
{
"type": "null",
"description": "The latest response returned by the tool."
}
],
"description": "Most recent submitted response, or null when unanswered."
}
},
"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",
"latest_response"
],
"additionalProperties": false,
"description": "Structured input request created by a conversation tool or agent run."
},
"description": "Input requests for the requested page."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor representing the current page."
},
"first": {
"type": "null",
"description": "Always null because these MCP pagination flows do not expose a first-page cursor."
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page, or null when there are no more results."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page, or null when unavailable."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursors for the input request list."
}
},
"required": [
"data",
"page_info"
],
"additionalProperties": false,
"description": "Paginated input request list response.",
"$schema": "http://json-schema.org/draft-07/schema#"
}