Skip to content
Docs menu

Attachments on a person

Keep images, files and links with someone in Venom People. Links show as cards with the service's mark and a title made from the address; nothing is fetched from the linked site.

View .md

A person's page has an Attachments section: the meeting notes, decks, contracts, photos and profiles that go with someone, in one place, the way Venom Notes keeps files, images and link cards in a note.

What you can keep

Kind What it looks like Limits
Images thumbnails; a tap opens the viewer with the caption, who added it and when, Download and Delete PNG, JPEG, WebP or GIF; up to 20 per person, 4 MB each (shrunk in the browser first)
Files a row with the file's type, name and size, who added it and when, Download, Edit and Delete PDFs, Word, Excel, PowerPoint and OpenDocument files, RTF, text, CSV, Markdown, JSON, audio, video and zip archives; 4 MB each
Links a card with the service's mark, a title, what the link is and its host, and your note; the whole card opens the link in a new tab any http or https address; up to 200 files and links per person

Images come first, then files and links together, newest first. Every file counts toward your organisation's files quota, the same one Venom Notes uses.

A file's type is read from its bytes, never from its name or the type your browser reports: a PDF renamed photo.png is kept as a PDF. SVG images and HTML pages are refused, because they can carry scripts. Files are served with nosniff and a sandboxing content policy; only images, PDFs, audio and video open in the browser, anything else downloads.

Adding

You add to your own people (on a contact you shared with a team or the organisation, your role has to write in People):

  • Add, at the top of the section: Files or photos (several at once), Take a photo on a phone, or Link (an address, an optional title and a note).
  • Drop files or a link on the section.
  • Paste while the section has focus (click or tab to it): a pasted image or file is uploaded, a pasted address becomes a link card.

Uploads show their progress; a file that cannot be kept says why. A picture you add is offered for a read into the profile, as Add snapshots does (Enrich a person from snapshots).

The same address is kept once per person: adding it again answers the card you already have.

An address of this Venom (a note, an issue, a deal, another person) is not kept as a card. It is linked to the person and shows under Linked items, with the item's own title and state. An address of an item you cannot see is refused.

A card shows a mark for the service, a title, what the link is ("Google Doc · docs.google.com") and your note. Click the title or anywhere on the card to open the link in a new tab. Edit renames it and changes the note; an empty title goes back to the default.

Nothing is fetched to draw a card. The title comes from the address alone: the service's label, plus what the address says when it says something readable:

Address Title
https://notes.granola.ai/d/… Granola note
https://docs.google.com/document/d/…/edit Google Doc
https://www.figma.com/design/…/Pricing-page Figma: Pricing page
https://github.com/acme/cloud/pull/12 GitHub: acme/cloud#12
https://www.linkedin.com/in/jane-doe-1a2b3c/ LinkedIn profile: Jane Doe
https://example.com/blog/how-we-price How we price · example.com

Most of these pages need a sign-in, so reading them would only find a login page. Venom does not visit them, and does not ask a favicon or preview service either.

Granola notes

A Granola link whose meeting your Meetings sync already holds takes that meeting's title, says In your Meetings sync, and has an In timeline link to the meeting's entry on the person's timeline. The title comes from your own sync, never from Granola's page.

Recognised services

Granola, Notion, Google Docs, Sheets, Slides, Forms, Drive and Meet, Zoom, Loom, Figma (and FigJam), Linear, GitHub, GitLab, Slack, Microsoft Teams, Word, Excel, PowerPoint, SharePoint and OneDrive, Dropbox, Box, Airtable, Miro, Calendly, Cal.com, LinkedIn, X, YouTube, Vimeo, Substack, Medium, HubSpot, Salesforce, DocuSign, Fireflies, Otter, Fathom and tl;dv. A host counts only as itself or one of its subdomains: notes.granola.ai is Granola, granola.ai.example.com is not.

The marks are plain lettermarks drawn in Venom's own icon style and shipped with the app. They are not the companies' logos, and nothing is loaded from the linked site. Any other address gets a link mark and its host.

Who sees what

Whoever may see the person sees their attachments: you for a private contact, the team or the organisation for a shared one. A person you cannot see answers "not found", and so does any of their attachments. Only the person's owner adds, renames and deletes.

Attachments show in the owner's timeline as Attached entries, by the day they were added, and People's search finds a person by an attachment's title, note or caption (the owner's search, like notes). Titles, notes and file contents are your data: People's AI never reads a file's contents, and treats the words you typed as data, never as instructions.

Archiving a person deletes their attachments and the files' bytes. Merging two people moves them to the person you keep (a link both had is kept once). Attachments are not part of the organisation backup, as People is not in it yet.

For agents

Tool What it does
people_attachment_list the images, files and links kept with a person, newest first (kind to narrow)
people_attachment_get one of them; include_bytes returns a file or image up to 1.5 MB as base64
people_attachment_add keep a link (url, optional title, note) or a file: upload_id (from people_image_prepare with for: "attachment" and a PUT of the raw bytes, up to 4 MB), file_url (a public address Venom fetches) or file_base64 with file_name (about 1.5 MB at most); a picture joins the images; a Venom item's address is refused (use workspace_item_link). See Files and pictures over MCP
people_attachment_update change a title (an image's caption) or a note
people_attachment_delete delete one

Each has a REST twin under /api/v1/people (People over MCP). The browser uses POST /api/workspace/people/attachments, PATCH and DELETE /api/workspace/people/attachments/{id}, and GET /api/workspace/people/files/{id} for a file's bytes.