{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/autodesk/json-schema/autodesk-signed-s3-download-schema.json",
  "title": "SignedS3Download",
  "description": "An object representing the response payload on successful execution of a Generate Signed S3 Download URL operation.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/autodesk-download-workflow-api-openapi.yml#/components/schemas/SignedS3Download",
  "type": "object",
  "properties": {
    "status": {
      "$ref": "#/$defs/DownloadStatus"
    },
    "url": {
      "type": "string",
      "description": "A S3 signed URL with which to download the object. This attribute is returned when ``status`` is ``complete`` or ``fallback``; in the latter case, this will return an OSS signed URL, not an S3 signed URL."
    },
    "urls": {
      "type": "object",
      "description": "A map of S3 signed URLs, one for each chunk of an unmerged resumable upload. This attribute is returned when ``status`` is ``chunked``. The key of each entry is the byte range of the total file which the chunk comprises."
    },
    "params": {
      "type": "object",
      "description": "The values that were requested for the following parameters when requesting the S3 signed URL.\n\n- ``Content-Type``\n- ``Content-Disposition``\n- ``Cache-Control``.\n"
    },
    "size": {
      "type": "integer",
      "format": "int64",
      "description": "The total amount of storage space occupied by the object, in bytes."
    },
    "sha1": {
      "type": "string",
      "description": "A hash value computed from the data of the object, if available."
    }
  },
  "required": [
    "status",
    "params",
    "size"
  ],
  "$defs": {
    "DownloadStatus": {
      "title": "DownloadStatus",
      "x-stoplight": {
        "id": "bufzykd0rpk39"
      },
      "type": "string",
      "description": "Indicates the current state of the object requested for download. Possible values are:\n\n- ``complete`` - The object is ready to be downloaded.\n- ``chunked`` - The object was uploaded in chunks, but assembly of chunks into the final object is still pending. Returned when ``public-resource-fallback`` = ``false`` in the request.\n- ``fallback`` - The object was uploaded in chunks, but assembly of chunks into the final object is still pending. Will return an OSS Signed URL instead of a S3 signed URL because ``public-resource-fallback`` was set to ``true`` in the request.\n- ``skipped`` - The server has evaluated an ``If-None-Match`` or ``If-Modified-Since`` parameter in the request and determined that the cached version of the object is still up-to-date.\n- ``error`` - There was an error in the request. Review and verify the requested ``bucketKey``, ``content-type``, and ``content-disposition`` before you try again.\n",
      "enum": [
        "complete",
        "chunked",
        "fallback",
        "skipped",
        "error"
      ]
    }
  }
}