Update user file MCP tool

• MCP tool name: Update_User_File
• Data type: User file data type
• Returns: User file MCP response
• Annotations: Not read only, destructive, idempotent, closed world
• Surfaces: GovTribe AI, GovTribe MCP, GovTribe Compact MCP server

Examples

Use Workspace Actions after finding the file ID with Search user files and, when linking, the pursuit ID with Search pursuits. File changes are shared with your workspace.

Rename a file and describe it

{
  "tool": "Update_User_File",
  "arguments": {
    "user_file_id": "6aa1620aed2ae46d750e9b55",
    "name": "FY27 Capability Statement.docx",
    "description": "Capability statement tailored to the recompete, drafted from the FY26 version."
  }
}

Link a file to a pursuit

{
  "tool": "Update_User_File",
  "arguments": {
    "user_file_id": "6aa1620aed2ae46d750e9b55",
    "pursuit_id": "6aa1620aed2ae46d750e9b60"
  }
}

Unlink a file from its pursuit

{
  "tool": "Update_User_File",
  "arguments": {
    "user_file_id": "6aa1620aed2ae46d750e9b55",
    "pursuit_id": null
  }
}

Provide at least one of name, description, or pursuit_id. Omit a field to keep its current value. A null or empty description clears it, and a null pursuit_id unlinks the file. A file belongs to at most one pursuit; the pursuit must be in your workspace and one you can update, and an unavailable pursuit returns a validation error without revealing whether it exists. Include the file extension in a new name; names are limited to 255 characters and cannot contain slashes or control characters. Hidden GovTribe AI working files and tool-result files cannot be changed. Use Move user files to change folders.

The response carries the file's ID, type, name, description, URL, folder placement, pursuit, and timestamps. Use Search user files with fields_to_return when you also need the summary, content snippet, size, tags, or download URL.

Related articles

• User file MCP response: Review the response shape returned by this tool.
• User file data type: Understand the shared record fields and relationships used by this tool.
• GovTribe AI: Review the GovTribe AI surface where this tool can be called.
• GovTribe for Agents: Use GovTribe for Agents as the starting point for MCP tools, MCP tool responses, and guides.
• MCP servers: Review where this MCP tool can be used.