---
title: "Upload PDF attachment"
method: POST
path: "/attachment/"
tags: ["attachment"]
---

# Upload PDF attachment

`POST /attachment/`

## Request

- Base URL: `https://eu-api.legalesign.com/api/v1`
- URL: `https://eu-api.legalesign.com/api/v1/attachment/`
- Auth: API key in header `Authorization`

## Request body

- AttachmentPost
  - `group` string, required: URI of the group name
  - `pdf_file` string, byte, required: Base64 encoded PDF file data, max size is a group setting, 5MB by default
  - `filename` string, required: Simple alphanumeric name ending .pdf
  - `user` string: Assign to group member if not the api user
  - `description` string

## Response `201`

Success. Attachment URI will be in Location header.

## Other responses

- `400`: Bad Request, read response for error information
- `401`: Unauthorized
- `429`: Throttled
- `500`: Usually unparseable JSON

## Changes

- **2025-09-26** `2e8288936d2d`: 1 info
  - endpoint added
- **2025-09-23** `3bf301e758f2`: 1 breaking
  - api path removed without deprecation
- **2025-09-19** `02fb3694e918`: 1 breaking, 1 info
  - removed the media type `example error report` for the response with the status `400`
  - added the media type `application/json` for the response with the status `400`

[Operation history](https://skmtc.dev/legalesign/apis/legalesign-api/changes/attachment/post.md)

---

[API](https://skmtc.dev/legalesign/apis/legalesign-api.md) - [All operations](https://skmtc.dev/legalesign/apis/legalesign-api/llms.txt) - [OpenAPI document](https://skmtc.dev/legalesign/apis/legalesign-api/revisions/e0fcb6197e2c?raw)