---
title: "Attachments resource"
description: "Pre-upload files; retrieve metadata; delete unused attachments."
image: "https://help.tidymessages.com/og.svg"
---

> Documentation Index
> Fetch the complete documentation index at: https://help.tidymessages.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Attachments resource

Pre-upload files; retrieve metadata; delete unused attachments.

## How it works

Pre-upload files; retrieve metadata; delete unused attachments. TidyMessages keeps channel-specific behavior explicit while providing stable identifiers, safe retries, and auditable lifecycle events.

## Set it up

1. Authenticate with a project key scoped to the intended environment and resource.
2. Validate identifiers, fields, channel capability, and consent before the request.
3. Persist resource IDs and reconcile asynchronous state from signed events.

## What to expect

- The operation is traceable by stable request and resource identifiers.
- Acceptance, provider delivery, and customer interaction remain separate states.
- Retries and reordered events do not duplicate the customer action.
> [!TIP] Keep API keys, signing secrets, customer addresses, and message bodies out of source and logs.

Source: https://help.tidymessages.com/api-imessage/attachments-resource/index.mdx