Attachments

POST /vaults/{vault}/files?name={file.ext}
Content-Type: image/png
(body: the file's bytes)

The file goes to the vault's Attachments folder (Anexos), in the person's Google Drive. The response brings the Markdown ready to put in a page:

{ "ref": "a3f9c21b7e-chart.png", "markdown": "![chart.png](Anexos/a3f9c21b7e-chart.png)" }

Images come back as ![name](Anexos/ref). Other files come back as a link [📎 name](Anexos/ref).

Example

curl -X POST "https://wire.ia.br/api/v1/vaults/principal/files?name=chart.png" \
  -H "Authorization: Bearer $PAPER_TOKEN" \
  -H "X-Paper-Account: $PAPER_ACCOUNT" \
  -H "Content-Type: image/png" \
  --data-binary @chart.png

Then append the Markdown to a page:

curl -X PATCH "https://wire.ia.br/api/v1/vaults/principal/pages/pa1k2m3n4o5p" \
  -H "Authorization: Bearer $PAPER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"append": "![chart.png](Anexos/a3f9c21b7e-chart.png)"}'

Rules

Rule	Value
Permission	Regular token with "Send files" and Read and edit on the vault
Maximum size	10 MB per file
Quantity	30 uploads per day, per token
Copies for AI	Don't receive files

What it's for, and what it isn't

Attachments exist for the person's notes: the photo of the meeting whiteboard, the PDF a page comments on, the chart a script generated for a report.

Don't use Paper to host images or files that other sites, apps or people will download. That includes using published links as a CDN. Hosting abuse leads to a permanent ban. See Fair use.

Cloud image hosting for the paid plan is a future feature and doesn't exist yet.

ExampleCopy Anchor Link

RulesCopy Anchor Link

What it's for, and what it isn'tCopy Anchor Link

On this page

Example

Rules

What it's for, and what it isn't