Skip to main content
POST
/
{projectSlug}
/
tasks
/
{taskId}
/
attachments
Upload attachment
curl --request POST \
  --url https://api.elean.app/v1/public/{projectSlug}/tasks/{taskId}/attachments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "id": "018e1b2c-aaaa-bbbb-cccc-000000000001",
  "filename": "screenshot.png",
  "url": "https://elean-attachments.example.r2.cloudflarestorage.com/workspace-id/task-id/file-id.png?X-Amz-Expires=3600&...",
  "mimeType": "image/png",
  "size": 204800,
  "createdAt": "2026-03-01T12:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

API key created in Workspace Settings → API Keys. Pass it in the Authorization header as a Bearer token, or in the X-API-Key header.

Format: el_ followed by 40 hex characters.

Path Parameters

​
projectSlug
string
required

The slug of the project.

Example:

"my-project"

​
taskId
string
required

UUID of the task, or its external ID (e.g. PROJ-42).

Example:

"018e1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c"

Body

multipart/form-data
​
file
file
required

The file to upload. Maximum size is 10 MB.

Response

Attachment uploaded successfully.

A file attached to a task.

​
id
string<uuid>

Unique identifier of the attachment.

Example:

"018e1b2c-aaaa-bbbb-cccc-000000000001"

​
filename
string

Original filename of the uploaded file.

Example:

"screenshot.png"

​
url
string<uri>

Presigned URL to download the attachment. Valid for 1 hour from the time of the request.

Example:

"https://elean-attachments.example.r2.cloudflarestorage.com/workspace-id/task-id/file-id.png?X-Amz-Expires=3600&..."

​
mimeType
string

MIME type of the file.

Example:

"image/png"

​
size
integer

File size in bytes.

Example:

204800

​
createdAt
string<date-time>

ISO 8601 timestamp of when the attachment was uploaded.

Example:

"2026-03-01T12:00:00.000Z"