Attachments

Attachments are supplementary files added to a document. They are sent along with the document but don’t require signatures.

Limits

• Maximum 5 attachments per document
• Maximum 10 MB per file
• Allowed types: PDF, JPG, PNG, WebP
• Images are automatically converted to PDF

List attachments

GET /api/v1/documents/{id}/attachments

Required scope: documents.read

curl

curl -X GET https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments \
  -H "Authorization: Bearer isk_YOUR_API_KEY"

JavaScript

const res = await fetch(
  'https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments',
  { headers: { 'Authorization': 'Bearer isk_YOUR_API_KEY' } }
);
const { data } = await res.json();

Python

res = requests.get(
    "https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments",
    headers={"Authorization": "Bearer isk_YOUR_API_KEY"}
)

Response

{
  "data": [
    {
      "id": "att_abc123",
      "fileName": "terms-and-conditions.pdf",
      "fileSize": 524288,
      "mimeType": "application/pdf",
      "order": 0,
      "createdAt": "2026-05-28T12:00:00.000Z"
    }
  ]
}

---

Upload an attachment

POST /api/v1/documents/{id}/attachments

Uploads a file as a multipart/form-data request. The document must be in draft status.

Required scope: documents.write

curl

curl -X POST https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments \
  -H "Authorization: Bearer isk_YOUR_API_KEY" \
  -F "file=@terms-and-conditions.pdf"

JavaScript

const formData = new FormData();
formData.append('file', fileBlob, 'terms-and-conditions.pdf');

const res = await fetch(
  'https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer isk_YOUR_API_KEY' },
    body: formData
  }
);
const { data } = await res.json();

Python

res = requests.post(
    "https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments",
    headers={"Authorization": "Bearer isk_YOUR_API_KEY"},
    files={"file": open("terms-and-conditions.pdf", "rb")}
)

Response 201 Created

{
  "data": {
    "id": "att_abc123",
    "fileName": "terms-and-conditions.pdf",
    "fileSize": 524288,
    "mimeType": "application/pdf",
    "order": 0,
    "createdAt": "2026-05-28T12:00:00.000Z"
  }
}

Note

Image files (JPG, PNG, WebP) are automatically converted to PDF. The response mimeType will always be application/pdf.

---

Delete an attachment

DELETE /api/v1/documents/{id}/attachments/{attId}

Removes an attachment from a draft document and deletes the file from storage.

Required scope: documents.write

curl

curl -X DELETE https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments/att_abc123 \
  -H "Authorization: Bearer isk_YOUR_API_KEY"

JavaScript

await fetch(
  'https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments/att_abc123',
  {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer isk_YOUR_API_KEY' }
  }
);

Python

requests.delete(
    "https://app.insigner.co/api/v1/documents/cm5x9abc123/attachments/att_abc123",
    headers={"Authorization": "Bearer isk_YOUR_API_KEY"}
)

Response: 204 No Content