Store file | Uploadcare docs

curl -X PUT https://api.uploadcare.com/files/21975c81-7f57-4c7a-aef9-acfe28779f78/storage/ \
     -H "Accept: application/vnd.uploadcare-v0.7+json" \
     -H "Authorization: <apiKey>"

{
  "datetime_stored": "2018-11-26T12:49:10.477888Z",
  "datetime_uploaded": "2018-11-26T12:49:09.945335Z",
  "is_image": true,
  "is_ready": true,
  "mime_type": "image/jpeg",
  "original_file_url": "https://ucarecdn.com/22240276-2f06-41f8-9411-755c8ce926ed/pineapple.jpg",
  "original_filename": "pineapple.jpg",
  "size": 642,
  "url": "https://api.uploadcare.com/files/22240276-2f06-41f8-9411-755c8ce926ed/",
  "uuid": "22240276-2f06-41f8-9411-755c8ce926ed",
  "content_info": {
    "mime": {
      "mime": "image/jpeg",
      "type": "image",
      "subtype": "jpeg"
    },
    "image": {
      "color_mode": "RGB",
      "orientation": 6,
      "format": "JPEG",
      "sequence": false,
      "height": 500,
      "width": 500,
      "geo_location": {
        "latitude": 55.62013611111111,
        "longitude": 37.66299166666666
      },
      "datetime_original": "2018-08-20T08:59:50",
      "dpi": [
        72,
        72
      ]
    }
  },
  "metadata": {
    "subsystem": "uploader",
    "pet": "cat"
  },
  "appdata": {
    "aws_rekognition_detect_labels": {
      "datetime_created": "2021-09-21T11:25:31.259763Z",
      "datetime_updated": "2021-09-21T11:27:33.359763Z",
      "data": {
        "LabelModelVersion": "2.0",
        "Labels": [
          {
            "Confidence": 93.41645812988281,
            "Instances": [],
            "Name": "Home Decor",
            "Parents": []
          },
          {
            "Confidence": 70.75951385498047,
            "Instances": [],
            "Name": "Linen",
            "Parents": [
              {
                "Name": "Home Decor"
              }
            ]
          },
          {
            "Confidence": 64.7123794555664,
            "Instances": [],
            "Name": "Sunlight",
            "Parents": []
          },
          {
            "Confidence": 56.264793395996094,
            "Instances": [],
            "Name": "Flare",
            "Parents": [
              {
                "Name": "Light"
              }
            ]
          },
          {
            "Confidence": 50.47153854370117,
            "Instances": [],
            "Name": "Tree",
            "Parents": [
              {
                "Name": "Plant"
              }
            ]
          }
        ]
      },
      "version": "2016-06-27"
    },
    "aws_rekognition_detect_moderation_labels": {
      "datetime_created": "2023-02-21T11:25:31.259763Z",
      "datetime_updated": "2023-02-21T11:27:33.359763Z",
      "data": {
        "ModerationModelVersion": "6.0",
        "ModerationLabels": [
          {
            "Confidence": 93.41645812988281,
            "Name": "Weapons",
            "ParentName": "Violence"
          }
        ]
      },
      "version": "2016-06-27"
    },
    "remove_bg": {
      "datetime_created": "2021-07-25T12:24:33.159663Z",
      "datetime_updated": "2021-07-25T12:24:33.159663Z",
      "data": {
        "foreground_type": "person"
      },
      "version": "1.0"
    },
    "uc_clamav_virus_scan": {
      "datetime_created": "2021-09-21T11:24:33.159663Z",
      "datetime_updated": "2021-09-21T11:24:33.159663Z",
      "data": {
        "infected": true,
        "infected_with": "Win.Test.EICAR_HDB-1"
      },
      "version": "0.104.2"
    }
  }
}

Store a single file by UUID. When file is stored, it is available permanently. If not stored — it will only be available for 24 hours. If the parameter is omitted, it checks the Auto file storing setting of your Uploadcare project identified by the public_key provided in the auth-param.

Authentication

Authorizationstring

Every request made to https://api.uploadcare.com/ MUST be signed. HTTPS SHOULD be used with any authorization scheme.

Requests MUST contain the Authorization header defining auth-scheme and auth-param: Authorization: auth-scheme auth-param.

Every request MUST contain the Accept header identifying the REST API version: Accept: application/vnd.uploadcare-v0.7+json.

There are two available authorization schemes:

For production: Uploadcare, a scheme where a signature, not your Secret API Key MUST be specified. Signatures SHOULD be generated on backend.
For quick tests: Uploadcare.Simple, a simple scheme where your Secret API Key MUST be specified in every request’s auth-param.

Every request made to `https://api.uploadcare.com/` MUST be signed. HTTPS SHOULD be used with any authorization scheme. Requests MUST contain the `Authorization` header defining `auth-scheme` and `auth-param`: `Authorization: auth-scheme auth-param`. Every request MUST contain the `Accept` header identifying the REST API version: `Accept: application/vnd.uploadcare-v0.7+json`. There are two available authorization schemes: * For production: `Uploadcare`, a scheme where a `signature`, not your Secret API Key MUST be specified. Signatures SHOULD be generated on backend. * For quick tests: `Uploadcare.Simple`, a simple scheme where your [Secret API Key](https://app.uploadcare.com/projects/-/api-keys/) MUST be specified in every request's `auth-param`.

Path parameters

uuidstringRequiredformat: "uuid"

File UUID.

Response

File stored. File info in JSON.

datetime_removeddatetime or null

Date and time when a file was removed, if any.

datetime_storeddatetime or null

Date and time of the last store request, if any.

datetime_uploadeddatetime

Date and time when a file was uploaded.

is_imageboolean

Is file is image.

is_readyboolean

Is file is ready to be used after upload.

mime_typestring

File MIME-type.

original_file_urlstring or nullformat: "uri"

Publicly available file CDN URL. Available if a file is not deleted.

original_filenamestring

Original file name taken from uploaded file.

sizeinteger

File size in bytes.

urlstringformat: "uri"

API resource URL for a particular file.

uuidstringformat: "uuid"

File UUID.

variationsobject or null

Dictionary of other files that were created using this file as a source. It’s used for video processing and document conversion jobs. E.g., <conversion_path>: <uuid>.

content_infoobject

Information about file content.

metadataobject

Arbitrary metadata associated with a file.

appdataobject

Dictionary of application names and data associated with these applications.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

406

Not Acceptable Error

429

Too Many Requests Error

Authentication

Path parameters

Headers

Response

Errors