Skip to main content
Back to Inbuilt tools The get_attachment_url tool returns a time-limited public URL for a file that the user uploaded during the conversation.

​
When to use

Use get_attachment_url when you need to give the URL of an uploaded file to another system, such as an external API or a ticketing tool, or to share the file in a message. To forward the file to an external system for you, use route_attachment.

​
Declare the tool

​
Parameters

​
Returns

A URL that can be fetched from outside the platform, with the lifetime it is valid for. Depending on the storage backend, this is a presigned storage URL or a platform-served download link. The platform may apply a shorter lifetime to the platform-served link, so use the lifetime in the result. If the attachment does not exist or does not belong to the current conversation, the tool returns ATTACHMENT_NOT_FOUND. If attachment_id is missing, it returns MISSING_PARAMETER.