veryfront__publish_project_filesAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project ID or slug. Requires project.files.write. |
file_references | string[] | No | File paths or UUIDs. Omit to commit all pending changes; [] commits none. |
branch_reference | string | No | Branch name or UUID. Omit for main. |
expected_version_id | string | No | Expected persisted version UUID; requires exactly one selected file. Format: uuid. |
expected_versions | object | No | Map from file paths or UUIDs to their expected persisted version UUIDs. Conflicting guards are rejected. |
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__publish_project_files",
"arguments": {}
}
}
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 |
|---|---|---|---|
success | boolean | Yes | True when every selected file committed. False may still include committed versions. |
versions | object[] | Yes | List of versions associated with this tool result. |
conflicts | object[] | Yes | List of conflicts associated with this tool result. |
problem | object or null | Yes | Stale persisted-version precondition. Other files may already have committed; refresh and retry only conflicted files. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug. Requires project.files.write."
},
"file_references": {
"type": "array",
"items": {
"type": "string",
"description": "One file reference item supplied to the tool."
},
"description": "File paths or UUIDs. Omit to commit all pending changes; [] commits none."
},
"branch_reference": {
"type": "string",
"description": "Branch name or UUID. Omit for main."
},
"expected_version_id": {
"type": "string",
"format": "uuid",
"description": "Expected persisted version UUID; requires exactly one selected file."
},
"expected_versions": {
"type": "object",
"additionalProperties": {
"type": "string",
"format": "uuid",
"description": "Additional structured values supplied to the tool."
},
"description": "Map from file paths or UUIDs to their expected persisted version UUIDs. Conflicting guards are rejected."
}
},
"additionalProperties": false,
"description": "Arguments for the publish_project_files tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"success": {
"type": "boolean",
"description": "True when every selected file committed. False may still include committed versions."
},
"versions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"file_id": {
"type": "string",
"format": "uuid",
"description": "Canonical committed file UUID."
},
"version_id": {
"type": "string",
"format": "uuid",
"description": "Created immutable version UUID."
},
"path": {
"type": "string",
"description": "Committed file path."
}
},
"required": [
"file_id",
"version_id",
"path"
],
"additionalProperties": false
},
"description": "List of versions associated with this tool result."
},
"conflicts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"file_id": {
"type": "string",
"format": "uuid",
"description": "Canonical file UUID whose draft was retained."
},
"path": {
"type": "string",
"description": "Conflicted file path."
},
"error": {
"type": "string",
"description": "Stale-version conflict reason."
}
},
"required": [
"file_id",
"path",
"error"
],
"additionalProperties": false
},
"description": "List of conflicts associated with this tool result."
},
"problem": {
"anyOf": [
{
"type": "object",
"properties": {
"status": {
"type": "number",
"const": 409,
"description": "Lifecycle status for the returned record."
},
"slug": {
"type": "string",
"const": "concurrency-error"
},
"detail": {
"type": "string"
}
},
"required": [
"status",
"slug",
"detail"
],
"additionalProperties": false,
"description": "Stale persisted-version precondition. Other files may already have committed; refresh and retry only conflicted files."
},
{
"type": "null",
"description": "The problem returned by the tool."
}
],
"description": "Stale persisted-version precondition. Other files may already have committed; refresh and retry only conflicted files."
}
},
"required": [
"success",
"versions",
"conflicts",
"problem"
],
"additionalProperties": false,
"description": "Structured result returned by the publish_project_files tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}