Hosts overview

A host profile is one upload target: an endpoint, credentials, and the rules for turning a response into a link. You can keep as many as you like side by side, switch the default at any time, and upload to several concurrently.

This page is the reference for what the fields mean. Each service then has its own page with the exact values to type.

Pick a host#

The three engines#

The Upload method picker at the top of the profile editor chooses one of three request shapes. Everything below it changes to match.

multipart/form-data#

A normal HTML form post — the file as one part, optional extra fields alongside it. This is what almost every image-host API speaks.

The multipart part's filename is the last path segment of your rendered object key. Most hosts ignore it and assign their own name.

Binary PUT / POST#

The file's bytes are the entire request body, with a Content-Type derived from the extension. There is no form, so there are no form fields and no file field name.

This is the engine for WebDAV-style endpoints and small self-hosted receivers, where the path decides the name:

Upload URL   https://files.example.com/{{key}}
Method       PUT
JSON path    (empty)
Final URL    https://files.example.com/{{key}}

S3-compatible (AWS SigV4)#

A signed PUT of the object, using AWS Signature Version 4. Dropline always signs path-style requests — endpoint/bucket/key — which is what R2, MinIO and self-hosted gateways expect, and which AWS still accepts.

There is no JSON path here: S3 replies with an empty body on success, so the URL is constructed rather than parsed.

The five authentication kinds#

For the multipart and binary engines. The secret itself always goes to the keychain, whichever kind you pick.

Custom header is the escape hatch. Because the value is sent verbatim, an API wanting Authorization: Client-ID abc123 is configured by setting the header name to Authorization and the value to the whole string Client-ID abc123.

Managing profiles#

• + adds a profile from a preset. − deletes the selected one.
• Set as Default marks which profile new uploads use; the default carries a green tick in the list.
• Test Upload sends an 8×8 PNG through the profile and reports the URL or the error. Use it after every change.
• Deleting a profile deletes its keychain entry with it.

All presets at a glance#