HTTP API - Attachments

This article provides an overview of the attachment-related endpoints and functionality available for the HTTP Data API. Attachments consist of two distinct parts: metadata and a binary large object (blob) datastore. (See ATTACHMENT)

Uploading Attachments

Using the Multipart Form method, upload the raw binary contents of the file you want to attach:

There are no size limits for attachments in Ditto, but the HTTP API enforces a 1MB limit for uploading attachments. This can be increased upon request.

Curl

curl -X POST "$HOST/api/v4/attachments/upload" \
  --header "Authorization: Bearer ${API_KEY}" \
  -F 'file=@post.png'
#=> {"id": "RUGMUxzHDRH1x94uH_QcrkzUhV5-j6oFd1c9eAFMxNZDmQ", "len": 261322}

Downloading Attachments

Using /api/v4/attachments/{attachment_id}, download attachments:

Curl

curl "$HOST/api/v4/attachments/${ATTACHMENT_ID}" \
  --header "Authorization: Bearer $API_KEY" \
  --output file.png

Execute a DQL query Find docs with Legacy QL

⌘I

Overview

Public Cloud (BYOC)

Cloud Portal

HTTP Data API

Data Integration

Reference

HTTP API - Attachments

Uploading Attachments

Downloading Attachments

​Uploading Attachments

​Downloading Attachments

Uploading Attachments

Downloading Attachments