Refresh document MCP response
MCP tool response returned by the Refresh document MCP tool.
- Returned by: Refresh document MCP tool
- Response type: Structured document payload
Response Shape
The response refreshes the expiring preview and download URLs for a document already shown through the document app.
| Field | Type | Notes |
|---|---|---|
id | string | GovTribe user file or government file identifier. |
govtribe_type | string | user_file or government_file. |
title | string | Display title for the document. |
filename | string | Source filename. |
extension | string | Lowercase file extension. |
mime_type | string or null | MIME type when known. |
viewer_url | string | Temporary URL for previewing the document. |
open_url | string | Temporary URL used to open the document. |
download_url | string | Temporary URL used to download the document. |
url_expires_at | string | ISO timestamp for the temporary URL expiration. |
govtribe_url | string | GovTribe web URL for the file record. |
query | string or null | Optional search text to locate in the document. |
scroll_to_query | boolean | Whether the viewer should scroll to the query. |
viewable | boolean | Whether the file can be previewed in the document app. |
Follow-up Behavior
Call Refresh_Show_Document when a document preview or download URL is expired or close to expiring.
Example
{
"id": "FILE_ID",
"govtribe_type": "user_file",
"title": "Pricing summary",
"filename": "pricing-summary.pdf",
"extension": "pdf",
"mime_type": "application/pdf",
"viewer_url": "https://govtribe.com/temporary/files/FILE_ID/view",
"open_url": "https://govtribe.com/temporary/files/FILE_ID/open",
"download_url": "https://govtribe.com/temporary/files/FILE_ID/download",
"url_expires_at": "2026-05-06T13:00:00+00:00",
"govtribe_url": "https://govtribe.com/workspaces/WORKSPACE_ID/files/FILE_ID",
"query": "pricing assumptions",
"scroll_to_query": true,
"viewable": true
}