Attachments Overview

Upload attachments to tasks using the ClickUp API. This guide outlines the key requirements for file uploads.

Key Requirements

• Content-Type : Use multipart/form-data in your request header, not application/json .
• File Upload Structure :
  • Attach files in the attachment[] array, such as attachment[0] , attachment[1] , etc.
  • Set custom_task_ids to true to use a custom ID in the task_id field. The team_id is required when using custom_task_ids as identifier.

Supported File Types and Limitations

• File Types : All file types are supported.
• Maximum File Size : Files can be up to 1 GB.
• Error Handling : A 4xx error with the code GBUSED_005 indicates that the account storage limit has been exceeded.

Multipart Form Data

Learn more in multipart/form-data here.

API Endpoint

• Endpoint : Create Task Attachment
• Method : POST
• Authorization : Requires a valid API token.

For additional parameters, request structure, and code examples in various programming languages, please refer to the API documentation.

Using Postman?

If you prefer to test API requests in Postman, you can set up a multipart/form-data request by following these instructions.

Handling these errors properly in your code will ensure smoother operation. For more details on error responses, see the API specification.