> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.sign.plus/llms.txt
> Use this file to discover all available pages before exploring further.
# Set Attachment Requests
The **Attachment Request** feature allows you to request recipients to upload files when signing their documents. This is particularly useful when you need additional documentation such as ID cards, driving licenses, payment receipts, or other supporting documents as part of your signature request.
Attachment requests are configured at the envelope level.
Once you have created an envelope and set a recipient using signing steps, you will get the `recipient_id` that you can use to set up attachment placeholders.
## Set up attachment placeholders
First, configure what attachments you want to collect by setting up placeholders:
```bash Set envelope attachment placeholders theme={null}
curl --request PUT \
--url https://restapi.sign.plus/v2/envelope/{envelope_id}/attachments/placeholders \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"placeholders": [
{
"recipient_id": "",
"id": "",
"name": "",
"hint": "",
"required": ,
"multiple":
}
]
}'
```
## Configure attachment settings
To configure attachment settings for a given envelope, check the set envelope attachment settings endpoint documentation.
By default, all recipients can see files attached by others. Setting `visible_to_recipients` to `"false"` ensures that only the envelope sender can access the attachment files provided by all signers.
```bash Set attachment settings theme={null}
curl --request PUT \
--url https://restapi.sign.plus/v2/envelope/{envelope_id}/attachments/settings \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"settings": {
"visible_to_recipients":
}
}'
```
## Download uploaded attachments
Once recipients have uploaded their files, you can download them:
```bash Download attachment files theme={null}
curl --request GET \
--url https://restapi.sign.plus/v2/envelope/{envelope_id}/attachments/{file_id} \
--header 'Authorization: Bearer '
```
On success, the API will return the requested attachment file.
## Using with templates
You can also set up attachment requests for templates, making them reusable across multiple envelopes:
```bash Set template attachment placeholders theme={null}
curl --request PUT \
--url https://restapi.sign.plus/v2/template/{template_id}/attachments/placeholders \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"placeholders": [
{
"recipient_id": "",
"id": "",
"name": "",
"hint": "",
"required": ,
"multiple":
}
]
}'
```
```bash Set template attachment settings theme={null}
curl --request PUT \
--url https://restapi.sign.plus/v2/template/{template_id}/attachments/settings \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"settings": {
"visible_to_recipients":
}
}'
```
Get endpoint details