apaas-attachment

name	apaas-attachment
description	Use for aPaaS Node SDK attachment and avatar operations: uploading, downloading, and deleting files with client.attachment.file.*, uploading and downloading avatar images with client.attachment.avatar.*, and safely handling binary payloads and record attachment fields.

aPaaS Attachment

Overview

Use this skill for client.attachment.file.* and client.attachment.avatar.*.

File Operations

const uploaded = await client.attachment.file.upload({
  file: fs.createReadStream("/path/to/file.zip")
});

const data = await client.attachment.file.download({
  file_id: "file_token"
});

await client.attachment.file.delete({
  file_id: "file_token"
});

upload posts multipart form field file to /api/attachment/v1/files. download returns binary data with responseType: "arraybuffer". delete is destructive and must be confirmed before use.

Avatar Operations

const avatar = await client.attachment.avatar.upload({
  image: fs.createReadStream("/path/to/avatar.jpg")
});

const imageData = await client.attachment.avatar.download({
  image_id: "image_token"
});

upload posts multipart form field image to /api/attachment/v1/images. download returns binary image data with responseType: "arraybuffer".

Record Fields

Before writing an attachment, avatar, or logo field on an object record, read object metadata with client.object.metadata.fields({ object_name }) and match the field's returned value shape. Do not assume upload response fields can be written directly to every attachment-like field.

Safety

• Confirm deletes before calling client.attachment.file.delete.
• Do not print binary payloads, raw file contents, access tokens, or private file metadata.
• Stream files from disk when possible; avoid loading large files into memory for ad hoc scripts.