---
updatedAt: 2026-10-01T15:07:58.000Z
agentTools:
projectIndex: https://developer.orangelogic.com/llms.txt
---
# Upload a file from Google Cloud Storage
Upload a single file from Google Cloud Storage to Orange Logic by providing a source bucket and object key
Uploads from Google Cloud Storage are always [processed fully in the background](https://developer.orangelogic.com/reference/upload#upload-processing-options). Record IDs and System Identifiers for the uploaded assets are generated immediately.
The behavior of this call depends on your duplicate detection configuration.
* When duplicate detection is off, you can use this call to upload any asset, even if it's a duplicate of an asset that's already stored in Orange Logic.
* When duplicate detection is on, this call returns the ID of the duplicate asset instead of uploading the new asset.
* When duplicate detection with checksum is on, this call returns the ID and version number of the duplicate asset instead of uploading the new asset.
Duplicate detection is off by default. Submit a support request to enable duplicate detection.
> 📙 Feature documentation
>
> Orange Logic users with a Link account can go to the following articles to learn more about each feature:
>
> * Duplicate detection
> * Checksum validation
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "upload-media-web",
"version": "1.0"
},
"servers": [
{
"url": "https://{OrangeLogicURL}/webapi/mediafile/import/upload",
"variables": {
"OrangeLogicURL": {
"default": "OrangeLogicURL"
}
}
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "oauth2",
"flows": {
"clientCredentials": {
"tokenUrl": "https://example.com/oauth2/token",
"scopes": {}
}
}
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/uploadFileFromCloudStorage_4OY_v1": {
"post": {
"summary": "Upload a file from Google Cloud Storage",
"description": "Upload a single file from Google Cloud Storage to Orange Logic by providing a source bucket and object key",
"operationId": "upload-from-cloud",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"sourceBucket",
"objectKey"
],
"properties": {
"recordID": {
"type": "string",
"description": "The record ID, unique identifier, or encrypted record ID of an existing asset. The file you provide will be uploaded as a new version of this asset.
This parameter or the folderRecordID parameter is required."
},
"folderRecordID": {
"type": "string",
"description": "The record ID, unique identifier, or encrypted record ID of a folder to upload the asset to. The file you provide will be uploaded as a new asset.
This parameter or the recordID parameter is required."
},
"sourceBucket": {
"type": "string",
"description": "The name of the bucket where the file to upload is stored"
},
"objectKey": {
"type": "string",
"description": "The path of the file within the source bucket to upload"
},
"FileName": {
"type": "string",
"description": "A name for the file being uploaded, including the file extension. Example: London Eye.jpg"
},
"logInfo": {
"type": "boolean",
"description": "Include logs in response. Set to true only for debugging.",
"default": false
},
"metadata": {
"type": "object",
"description": "Metadata applied to the uploaded asset.",
"properties": {
"[custom_Metadata]": {
"type": "string",
"description": "Enter a comma-separated list of field name and value pairs, enclosed in curly brackets: {}
Example: {\"CoreField.Title\":\"New asset title\", \"MyNameSpace.MyField\":\"Custom field value\"}"
}
}
},
"indexInBackground": {
"type": "boolean",
"description": "Set to `true` to delay indexing and speed up the API call processing time. This parameter is available beginning in [Orange Logic Ottawa](https://developer.orangelogic.com/reference/about#orange-logic-api-versioning).",
"default": true
},
"indexingPriority": {
"type": "string",
"description": "Forces the records to be indexed in a lower-priority queue to avoid impacting the primary indexing queue. For example, if you are calling large batches of records, the calls might fire faster than the database can index them. You can append &IndexingPriority=Low to avoid overloading the queue. Leave this parameter blank to keep the call in a high priority indexing queue. This parameter is available beginning in [Orange Logic Ottawa](https://developer.orangelogic.com/reference/about#orange-logic-api-versioning).",
"enum": [
"Medium",
"Low",
"VeryLow"
]
}
}
},
"examples": {
"Request Example": {
"value": {
"folderRecordID": "2Z0ZIFG1P7I5",
"sourceBucket": "input-source-for-dam",
"objectKey": "/File extension/Image/E-45 _col.jpg",
"fileName": "London.jpg",
"logInfo": false,
"metadata": {
"CoreField.CaptionLong": "London skyline with view of the Big Ben clocktower and the Houses of Parliament building",
"CoreField.Purpose": "Internal Use Only",
"CoreField.CT_RecordidSource": "Anna Morado"
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"Identifier\": \"Q0LXRLS9S\",\n \"RecordID\": \"2Z0ZIFLXK8W41\",\n \"IsDuplicated\": false\n}"
}
},
"schema": {
"type": "object",
"properties": {
"Identifier": {
"type": "string",
"example": "Q0LXRLS9S"
},
"RecordID": {
"type": "string",
"example": "2Z0ZIFLXK8W41"
},
"IsDuplicated": {
"type": "boolean",
"example": false,
"default": true
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```