Export Label Artifact

Generate (or return cached) label artifact(s) for one serving.

On the first request for a given (recipe version, serving, format, resolution) combination the label HTML is assembled, rendered by the label-renderer Lambda, and the result is permanently cached in S3. Subsequent requests return the cached artifact without re-rendering.

Concurrent first-download requests are safe — only one PUT lands; all others receive a pre-signed URL for the same artifact.

Organizations in their trial period always receive a DRAFT-watermarked artifact, regardless of the draft_watermark parameter — as do organizations whose billing status cannot currently be confirmed. Otherwise the watermark is controlled via that parameter.

Organizations on a non-subscription plan (past_due/expired/ cancelled) may still re-fetch an already-cached artifact, but a request that would require a fresh render (bm-be#2296) is denied with a 402.

Available only on API versions declaring the recipe_versioning capability.

curl -X GET "https://api.bettermenu.live/studio/recipes/string/servings/string/label-export"

{
  "label_format": "standard_vertical",
  "resolution": "print",
  "version_id": "string",
  "artifacts": [
    {
      "format": "string",
      "artifact_url": "string",
      "expires_at": "2019-08-24T14:15:22Z"
    }
  ],
  "meta": {
    "version": "string",
    "request_id": "string",
    "timestamp": "string"
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}