paperclip_download_attachment
Download an attachment's content by its UUID. Retrieve base64-encoded file data along with metadata like content type and size, returning either a markdown summary or full JSON envelope.
Instructions
Fetch the content of an attachment by ID from the Paperclip API.
Args:
attachmentId: string — Attachment UUID (example: "att_abc123")
response_format: 'markdown' | 'json' — Output format (default 'markdown')
Returns: Returns a fixed envelope with fields: attachmentId, contentType, size (bytes), contentBase64 (base64-encoded file content). When response_format is 'markdown', produces a compact summary (id, contentType, size, base64 snippet). When response_format is 'json', returns the full envelope as structured JSON.
Examples:
Use when: reading a previously uploaded attachment to extract its content
Don't use when: you need the attachment metadata only — use paperclip_list_attachments for id, filename, size
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
404: attachment not found → verify UUID with paperclip_list_attachments
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| attachmentId | Yes | Attachment UUID | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |