Attach File (Multipart Upload)

POST /public/action/attachments/create

Uploads a file (multipart) and attaches it to a record.

Authentication: X-API-KEY header (see Authentication).

Query parameters

Parameter	Type	Required	Description
id	string	Yes	Id of the record to attach the file to, or the FileAsset folder ID when type is FOLDER.
type	enum	Yes	Object type: CLIENT, PROJECT, DELIVERABLE, OPPORTUNITY, EXPENSE, TICKET, FOLDER.
file	file	Yes	The file part (multipart/form-data).

Request

curl -X POST "https://api.withmoxie.com/public/action/attachments/create?id=FOLDER_ID&type=FOLDER" \
  -H "X-API-KEY: your_api_key_here" \
  -F "file=@/path/to/file.pdf"

Upload into a folder

Set type=FOLDER and id to the existing FileAsset folder ID in the API key's workspace. This works for nested folders and does not require MCP. The folder ID is distinct from a client, project, or task ID. Missing folders, folders from another workspace, deleted folders, and folders beneath a deleted parent are rejected.

Uploading the same filename into the same folder adds a new file version. The response is a temporary signed download URL.

Response

Returns the stored file reference / URL as a plain string.

"https://files.withmoxie.com/10016/clients/66b0f2a1.../contract.pdf"