Lampiran

Unggah file ke AgentSend dan lampirkan ke pesan keluar. Ambil URL presigned untuk mengunduh atau membagikan konten lampiran.

💡

Unggah lampiran terlebih dahulu, lalu rujuk id-nya di field attachmentIds saat mengirim pesan. Lampiran disimpan dengan aman dan dapat diakses melalui URL presigned dengan batas waktu.

Unggah Lampiran

POST /attachments

Mengunggah file dan mengembalikan objek Attachment. Gunakan id yang dikembalikan untuk melampirkan file ke pesan. Request harus menggunakan enkoding multipart/form-data.

Body Request

Content-Type: multipart/form-data

Field	Tipe	Deskripsi
`file` wajib	file	File untuk diunggah. Nama file dan tipe konten disimpulkan dari bagian yang diunggah.

Contoh Request

bash

curl -X POST https://api.agentsend.io/attachments \
  -H "x-api-key: $AGENTSEND_API_KEY" \
  -F "file=@/path/to/report.pdf"

javascript

const form = new FormData();
form.append("file", fileBlob, "report.pdf");

const res = await fetch("https://api.agentsend.io/attachments", {
  method: "POST",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
  body: form,
});

const attachment = await res.json();
console.log(attachment.id); // use this id when sending a message

Respons — 201 Created

json

{
  "id": "att_01j9zxkp4qbc7n3m8td5e6fvg2",
  "filename": "report.pdf",
  "contentType": "application/pdf",
  "size": 204800,
  "url": "https://storage.agentsend.io/att_01j9zxkp4qbc7n3m8td5e6fvg2/report.pdf?token=...",
  "createdAt": "2025-11-10T08:15:00Z"
}

Ambil Lampiran

GET /attachments/{id}

Mengambil metadata dan URL unduhan presigned berumur pendek untuk lampiran. Gunakan field url untuk mengunduh atau menampilkan konten file secara langsung.

Parameter Path

Parameter	Tipe	Deskripsi
`id` wajib	uuid	ID lampiran untuk diambil.

Contoh Request

bash

curl https://api.agentsend.io/attachments/att_01j9zxkp4qbc7n3m8td5e6fvg2 \
  -H "x-api-key: $AGENTSEND_API_KEY"

Respons — 200 OK

json

{
  "id": "att_01j9zxkp4qbc7n3m8td5e6fvg2",
  "filename": "report.pdf",
  "contentType": "application/pdf",
  "size": 204800,
  "url": "https://storage.agentsend.io/att_01j9zxkp4qbc7n3m8td5e6fvg2/report.pdf?token=...",
  "createdAt": "2025-11-10T08:15:00Z"
}

Objek Attachment

Field	Tipe	Deskripsi
`id`	string	Pengenal unik untuk lampiran.
`filename`	string	Nama file asli seperti yang disediakan saat unggah.
`contentType`	string	Tipe MIME file (misalnya `application/pdf`, `image/png`).
`size`	number	Ukuran file dalam byte.
`url`	string	URL presigned untuk mengunduh file. URL ini dibatasi waktu; ambil yang baru dengan memanggil endpoint ini lagi jika kedaluwarsa.
`createdAt`	string	Timestamp ISO 8601 saat lampiran diunggah.

ℹ

URL presigned kedaluwarsa setelah periode singkat. Jika Anda perlu membagikan atau mengunduh ulang lampiran, panggil GET /attachments/{id} lagi untuk mendapatkan URL baru.

← Sebelumnya API: Akun