# Documents, links and files

> Give guests what they need to read: Attend documents with published versions, links to other sites, and uploaded files such as PDFs, attached to the whole event or to one session or group.

- Do first: [Find the event and the people in it](https://www.attend.vip/help/agents/find-your-event.md)
- Attend MCP tools: `events__listAllEventDocs`, `events__createEventDocument`, `events__updateEventDocument`, `rooms_edge__publishEventDocument`, `events__listEventDocumentVersions`, `events__rollbackEventDocument`, `events__unpublishEventDocument`, `events__createEventLink`, `events__updateEventLink`, `events__listEventLinks`, `namespace_edge__getEventFilesConfig`, `namespace_edge__createEventFileUpload`, `namespace_edge__finalizeEventFile`, `namespace_edge__publishEventFile`, `namespace_edge__unpublishEventFile`, `namespace_edge__deleteEventFile`, `namespace_edge__restoreEventFile`, `events__listEventFiles`, `events__updateEventFile`, `events__reorderEventContent`
- Updated: 2026-11-02

There are three kinds of content. Each can be shown to everyone, or attached to one session, activity, choice group or guest group: pass `agendaItemId`, `agendaActivityId`, `agendaGroupId` or `attendeeGroupId`. `quickLink` pins an item to the guest Home screen.

## Documents (written in Attend, with versions)

1. `events__listAllEventDocs` lists the event's documents.
2. `events__createEventDocument` creates one (`slug`, `title`, optional `kind`). Change its title, kind or attachment with `events__updateEventDocument`.
3. `rooms_edge__publishEventDocument` publishes the current draft as a new version, with an optional `label`. Guests only ever see published versions.
4. **Versions.**
   - `events__listEventDocumentVersions` lists them, newest first.
   - `events__rollbackEventDocument` makes an earlier version the one guests see.
   - `events__unpublishEventDocument` hides the document but keeps every version.
   - Both take `dryRun`.

## Links (to other sites)

`events__createEventLink` takes `title` and an `https://` `url`. Edit with `events__updateEventLink`; list with `events__listEventLinks`.

## Files (uploaded PDFs, images, Office files)

1. `namespace_edge__getEventFilesConfig` says whether Files is switched on for this event, the allowed types and how much space is left. Allowed: PDF, PNG, JPEG, WebP, DOCX, XLSX and PPTX, up to 150 MB each and 1 GB per event.
2. `namespace_edge__createEventFileUpload` (`fileName`, `contentType`, `byteSize`) returns a short-lived upload URL. PUT the file's bytes to it with the headers it returns.
3. `namespace_edge__finalizeEventFile` (`mediaId`) checks the bytes and creates the file as a **draft**. Pass an existing `fileId` to replace that file's contents with a new version.
4. `namespace_edge__publishEventFile` makes it visible to its audience; `namespace_edge__unpublishEventFile` hides it again.
5. `namespace_edge__deleteEventFile` moves it to the trash, where it can be restored with `namespace_edge__restoreEventFile` for 30 days.
6. `events__listEventFiles` lists files, and `events__updateEventFile` changes the title, audience or Home pin.

Set the order of everything on guest Home and in the library with `events__reorderEventContent`. Every step above that changes something takes `dryRun`.
