Lolly Beta
Launch App

ManageJobs, sharing and delivery

Organisation delivery destinations

Note: Lolly Work

This guide covers the optional organisation service. Configuration, console and API paths refer to your Lolly Work instance. The packaged console keeps its release-matched copy of this guide.

Your team finishes a poster, and it has to reach the campaign archive exactly as approved. This page is for the admin who sets up those fixed organisation destinations in Lolly Work, and for the people and automations that send to them. Delivery sends one finished Lolly export to a destination your organisation owns: S3-compatible storage (such as AWS S3, MinIO, Ceph RGW or Garage), WebDAV (including Nextcloud and ownCloud), an HMAC-signed HTTPS receiver, Brandfolder or Cloudinary.

How delivery differs from a source

A catalog provider brings remote assets into Lolly, normally read-only. Delivery sends a generated output out. Reusing one credential for both would silently turn read authority into write authority, so the two keep separate contracts, registries and secrets.

Pick an adapter

AdapterCredentialAfter writing, Lolly Work checksRevoke
s3<accessKeyId>:<secretAccessKey>a signed HEAD confirms the sizeno
webdav<username>:<app-password>, or bearer:<token>authenticated HEAD and a bounded GET confirm size and SHA-256no
httpsa dedicated random HMAC secretthe receiver's returned digest, when it sends oneno; the protocol has no safe universal delete
brandfolderan API token used only for writingreads the original back and compares SHA-256no; it never updates, replaces, moves or deletes an asset
cloudinaryJSON { "apiKey", "apiSecret" }reads the original back and compares SHA-256no; an id collision is never replaced

S3, WebDAV and signed HTTPS refuse redirects, and Brandfolder refuses API and upload redirects. S3 and WebDAV receipts record transformation: "none" and the delivered digest. Signed HTTPS derives that status from the receiver's digest rather than assuming every publisher keeps bytes unchanged.

Configure a destination

Destinations live in the instance configuration under delivery. Every destination has an id, a kind, a label, a credentialRef (the environment variable that holds its secret), enabled, the groups that may see it, the formats it accepts and an optional maxBytes below the instance-wide delivery.maxBytes.

Warning: Use a credential made for this destination

Use a write credential dedicated to one destination and restricted to its bucket, folder or section. Do not reuse a catalog-provider credential, the instance BlobStore credential or an operator's broad release key.

Configure a fixed S3 destination

{
  "delivery": {
    "maxBytes": 67108864,
    "destinations": [
      {
        "id": "campaign-archive",
        "kind": "s3",
        "label": "Campaign archive",
        "credentialRef": "LW_DESTINATION_CAMPAIGN_ARCHIVE",
        "enabled": true,
        "groups": ["marketing", "brand"],
        "formats": ["svg", "png", "jpg", "pdf"],
        "maxBytes": 33554432,
        "options": {
          "bucket": "approved-output",
          "endpoint": "https://minio.example.org",
          "region": "us-east-1",
          "prefix": "campaigns"
        }
      }
    ]
  }
}

Set the referenced secret in the deployment environment:

LW_DESTINATION_CAMPAIGN_ARCHIVE='<accessKeyId>:<secretAccessKey>'

publicBaseUrl is optional and means exactly what it says: when present, Lolly Work marks the destination public and returns the matching object URL in the receipt. An unguessable public URL is not access control.

Configure a fixed WebDAV destination

The collection, and any prefix subdirectory, must already exist. Delivery neither browses the account nor creates folders; it writes only beneath the fixed collection URL.

{
  "id": "team-files",
  "kind": "webdav",
  "label": "Approved team files",
  "credentialRef": "LW_DESTINATION_TEAM_FILES",
  "enabled": true,
  "groups": ["brand"],
  "formats": ["svg", "png", "pdf"],
  "options": {
    "url": "https://cloud.example/remote.php/dav/files/team/outgoing",
    "prefix": "approved"
  }
}

Set LW_DESTINATION_TEAM_FILES='<username>:<app-password>', or bearer:<token> for a token-fronted DAV server. For Nextcloud, use a revocable app password, not the account password. A predictable flat filename makes a retry overwrite the same resource. publicBaseUrl is optional and separate from the credentialed collection URL.

Configure a signed-HTTPS destination

This adapter connects an organisation-owned publishing service without tying Lolly Work to its vendor or API. The target is one exact HTTPS endpoint, not a webhook a person types in:

{
  "id": "press-publisher",
  "kind": "https",
  "label": "Press publisher",
  "credentialRef": "LW_DESTINATION_PRESS_PUBLISHER",
  "enabled": true,
  "groups": ["communications"],
  "formats": ["png", "jpg", "pdf"],
  "options": { "url": "https://publisher.example/lolly-delivery" }
}

Set the referenced variable to a dedicated random HMAC secret. Lolly Work sends the raw export body with x-lolly-delivery-id, x-lolly-format, a base64url x-lolly-name, x-lolly-content-sha256, x-lolly-timestamp and x-lolly-signature: v1=<hex-hmac-sha256>. The signed canonical string is:

lolly-delivery-v1\n<timestamp>\n<delivery-id>\n<format>\n<base64url-name>\n<content-type>\n<size>\n<sha256>

The receiver should reject stale timestamps and duplicate delivery ids. It may return no body, or JSON { "id": "…", "url": "https://…", "sha256": "…" } (at most 64 KiB). A matching digest records transformation: "none", a different digest records "provider-managed", and no digest records "unknown".

Configure Brandfolder writes

Use a separate write credential, even when Brandfolder is already a catalog source: the read-only source does not grant delivery permission. Configure one existing Brandfolder and file section per destination:

{
  "id": "brandfolder-campaigns",
  "kind": "brandfolder",
  "label": "Brandfolder campaigns",
  "credentialRef": "LW_DESTINATION_BRANDFOLDER",
  "enabled": true,
  "groups": ["brand"],
  "formats": ["png", "jpg", "pdf"],
  "projectFiles": true,
  "options": {
    "brandfolderId": "your-brandfolder-id",
    "sectionId": "your-section-id",
    "visibility": "private",
    "uploadOrigins": ["https://your-qualified-upload-origin.example"],
    "downloadOrigins": ["https://your-qualified-original-origin.example"]
  }
}

The adapter follows Brandfolder Binary Upload: it requests a temporary upload ticket, uploads the original, then creates one asset in the chosen section. Brandfolder's temporary object URL is reachable by its importer and managed by the vendor. As of October 2026, Brandfolder's documentation says upload URLs expire after 24 hours and temporary objects after seven days. Lolly Work never publishes its own source blob or returns those temporary URLs to the shell.

A private progress record is saved before creation and again with the created asset ID, so a processing or verification failure retries that known asset without uploading or creating it again. If the create response is lost, Brandfolder documents no idempotency key, so the delivery stops with an uncertain-outcome message. An operator must reconcile the asset before another create is attempted; do not create a fresh delivery just to get past the message. The adapter does not assign collection membership.

Configure Cloudinary writes

This adapter stores authenticated raw originals in a product environment that uses dynamic folders. It does not generate image or video renditions or publish a public CDN URL.

{
  "id": "cloudinary-originals",
  "kind": "cloudinary",
  "label": "Cloudinary originals",
  "credentialRef": "LW_DESTINATION_CLOUDINARY",
  "enabled": true,
  "groups": ["brand"],
  "formats": ["png", "jpg", "svg", "pdf", "mp4"],
  "maxBytes": 67108864,
  "projectFiles": true,
  "options": {
    "cloudName": "your-cloud",
    "region": "eu",
    "folderMode": "dynamic",
    "assetFolder": "campaigns",
    "publicIdPrefix": "lolly-deliveries"
  }
}
Note: Test a DAM destination before you enable it

Both DAM adapters are fixture-tested. Before enabling one, use a dedicated test section or folder to check credentials, tenant settings, readback, access, processing time and timeout recovery on your own tenant.

Send a shared original

With projectFiles: true on a DAM destination, the Assets view offers that destination when the selected asset is a shared-project original. The shell posts an empty body to /api/v1/destinations/:id/deliveries?projectId=...&fileId=...&checksum=...; no name or format override is accepted. The server reads the ready file, verifies every stored part and the whole digest, and works out the format from the bytes, with the stored filename as a fallback. The destination's format list and size limit apply, and no browser download and upload round trip is needed.

What happens when you send

A raw body is accepted only when it carries Lolly's C2PA export assertion. Before anything leaves, Lolly Work records its SHA-256 and stages the exact bytes in the configured BlobStore.

  1. awaiting approvalonly when the destination has an approval chain
  2. queuedthe exact bytes are staged
  3. deliveringone attempt at a time, across replicas
  4. delivereda receipt with the delivered digest
  • failed, then retryThe same staged bytes and, for S3, the same key.
  • rejected or cancelledA reviewer rejects, or the sender withdraws. Final: retry cannot bypass the decision.
  • Interrupted while deliveringHeld for an operator to reconcile, never taken over automatically.
  • Destination changedRetry answers 409 DESTINATION_CHANGED; make a new delivery.

A delivery waits for approval when its destination has a chain, then is queued, delivered or failed. A retry sends the same staged bytes again; a reject or a withdrawal ends the delivery.

signed by Lollywork-delivery-lifecycle.htmlHTMLpixels, not shapes11 KBAI generatedgenerated by Claude Opus 5.5Check it yourselfGet the signed file

Delivering an automation output

POST /api/v1/jobs/:id/deliveries sends a completed render job owned by the same member or service principal, and POST /api/v1/renders/:id/deliveries does the same for a succeeded durable render. The JSON body is { "destinationId": "campaign-archive", "name": "Launch poster" }; an optional format must equal the recorded format and cannot override that format. Both routes run one code path, and a durable render also checks that its owner still holds the tool and export.server.

When the job completes, Lolly Work records a SHA-256 over the actual output bytes, independently of the storage provider (an S3 ETag is not a portable content digest). Delivery reads the stored result, checks it against that digest, verifies its Lolly Content Credential again, then points the delivery's private sourceRef at the existing blob. There is no download and upload round trip and no second stored copy. Jobs completed before digests were stored must be rendered again before this route can deliver them.

The receipt shows sourceJobId or sourceRenderId for correlation, never the private storage reference. The source job cannot be deleted while any delivery keeps its output (409 JOB_OUTPUT_IN_USE), even after a successful send, so retry and audit cannot be undermined by deleting their evidence. A durable render's output retention leaves alone any output a delivery points at, for the same reason.

Optional human approval

Set approvalChain on a destination to an existing chain id. Creation then returns 202 with state: "awaiting-approval" and an approvalId, and nothing has been sent. The approval subject is the delivery id, whose record already binds the destination version, name, format, size and digest, and a final approval sends that exact staged record.

How chains work is on Approvals.

Who may send

delivery.create is the right to send to a fixed organisation destination. Members carry it by default, because the operator has already chosen, credentialed and enabled each destination. The destination's groups and resource grants narrow it further:

lw grants add group:contractors delivery.create 'destination:campaign-archive' --effect deny

Grants in general are on Roles and grants.

API example

curl -X POST \
  -H 'Cookie: lw_session=…' \
  -H 'Content-Type: image/png' \
  -H 'Idempotency-Key: campaign-42-poster-v1' \
  --data-binary @poster.png \
  'https://work.example.com/api/v1/destinations/campaign-archive/deliveries?name=Launch%20poster&format=png'

Discovery and history routes are in the API reference.

Check a destination against a live system

The S3 adapter has been checked against a live S3-compatible host. WebDAV and signed HTTPS have injected-wire tests, and opt-in checks in the Lolly Work repository that have not yet run against a real tenant or receiver, so neither is called live-verified.

The opt-in interoperability checks

Three gated tests in the Lolly Work repository check each adapter against a real endpoint. Each is skipped unless its switch is set to 1. It writes inert text under a random canary-<uuid> delivery id and removes that exact object afterwards, or fails and lists each id whose removal it could not confirm. None of them lists or browses the remote side or prints a credential.

TestSwitchSettings (each prefixed with the switch name)
tests/s3-upcloud-canary.test.tsLW_S3_CANARY_ENDPOINT, _REGION, _BUCKET, _ACCESS_KEY, _SECRET_KEY
tests/webdav-delivery-canary.test.tsLW_WEBDAV_CANARY_URL, _CREDENTIAL, optional _PREFIX
tests/https-delivery-canary.test.tsLW_HTTPS_CANARY_URL, _SECRET, _CLEANUP_URL, optional _CLEANUP_CREDENTIAL

The S3 test accepts any S3-compatible endpoint. Point the WebDAV test at an existing collection set aside for the test: it delivers twice to confirm that a retry overwrites the same resource, then reads the bytes back with its own request.

The signed-HTTPS protocol has no delete contract, so that test deletes through the receiver's own management API. LW_HTTPS_CANARY_CLEANUP_URL is an HTTPS URL with one {id} placeholder, filled with the id from each receipt, and a GET of the same URL must then answer 404 or 410. When a receipt is missing, unusable or has no id, the test uses the delivery id instead and counts the item as removed only when the DELETE succeeds. If the management API cannot resolve delivery ids, the test reports the cleanup as unconfirmed, and the operator must check the receiver by hand. When the receipt carries a digest, it must match the bytes sent. A second HTTPS test sends three requests the receiver must refuse with a 4xx status: a signature from another secret, a timestamp a day old and a body that does not match its signed digest.

Not built yet

Any further DAM destination must declare how it writes (create, new version or replace) and its conflict policy before it writes anything. Transfer acceptance, processing, original readiness, review and public activation need separate observations, and an uncertain completion must be reconciled against the remote asset and its committed effects before another write. Approval of a source cannot stand in for approval of the staged final digest. These are requirements for a new destination, not capabilities of the current adapters.