veryfront__list_file_versionsAccess
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 |
|---|---|---|---|
file_path | string | Yes | Project-relative source path, or the file ID. Minimum length: 1. |
ref | string | No | main or branch:<name-or-id>. Omit for main. Releases and environments have no version history. |
cursor | string | No | Opaque page_info.next from the previous page. |
limit | integer | No | Versions per page, 1 to 100 (default 20). Minimum: 1. Maximum: 100. |
project_reference | string | No | Project ID or slug (defaults to the current project) |
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_file_versions",
"arguments": {
"file_path": "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": {
"file_path": {
"type": "string",
"minLength": 1,
"description": "Project-relative source path, or the file ID."
},
"ref": {
"type": "string",
"description": "main or branch:<name-or-id>. Omit for main. Releases and environments have no version history."
},
"cursor": {
"type": "string",
"description": "Opaque page_info.next from the previous page."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Versions per page, 1 to 100 (default 20)."
},
"project_reference": {
"type": "string",
"description": "Project ID or slug (defaults to the current project)"
}
},
"required": [
"file_path"
],
"additionalProperties": false,
"description": "Arguments for the list_file_versions tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"binary": {
"type": "object",
"properties": {
"content_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"byte_size": {
"type": "integer",
"minimum": 0,
"maximum": 8388608
},
"content_type": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[\\x20-\\x7e]+$"
}
},
"required": [
"content_hash",
"byte_size",
"content_type"
],
"additionalProperties": false
},
"id": {
"type": "string",
"description": "Version ID."
},
"file_id": {
"type": "string",
"description": "File ID, when the content source supplies it."
},
"path": {
"type": "string",
"description": "Path of the file at this version."
},
"type": {
"type": "string",
"enum": [
"page",
"function",
"component",
"file"
],
"description": "File kind: page, function, component or file."
},
"created_at": {
"type": "string",
"description": "Time the version was created, RFC 3339."
},
"created_by": {
"type": [
"string",
"null"
],
"description": "ID of the user recorded for the version, or null."
},
"size_bytes": {
"type": "number",
"description": "Size of the version content in UTF-8 bytes, when the content source returns it."
}
},
"required": [
"id",
"path",
"type",
"created_at",
"created_by"
],
"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_file_versions tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}