> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insert Object

Stores a new object. The uploaded object replaces any existing object with the same name.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [GCP documentation](https://cloud.google.com/storage/docs/json_api/v1/objects/insert).

## Basic Parameters

| Parameter | Description |
| - | - |
| Bucket Name | Name of the bucket in which to store the new object. |
| File Content Type | The content type of the provided file. If no value is provided, defaults to `application/octet-stream`. |
| File Identifier | The identifier of the file. You can create a file identifier using the `Set File Variable` action. |
| Metadata | User-provided metadata, in key/value pairs. For example: `{"name": "myFile"}` |
| Object Name | Name of the object. |

## Advanced Parameters

| Parameter | Description |
| - | - |
| Cloud KMS Key | Resource name of the `Cloud KMS key` that will be used to encrypt the object.  If not specified, the request uses the bucket's default Cloud KMS key, if any, or else it uses standard Cloud Storage encryption. |
| Content Encoding | Sets the `contentEncoding` property of the final object to this value, to indicate the encoding of the content being uploaded. |
| Exclude Generation | Makes the request conditional on whether the object's current **generation** does not match the given value. If no live object exists, the precondition fails. Setting to `0` makes the operation succeed only if there is a live version of the object. |
| Generation Match | Makes the request conditional on whether the object's current **generation** matches the given value. Setting to `0` makes the request succeed only if there are no live versions of the object. |
| Predefined Access Control | Apply a predefined set of access controls to this object. For more information refer to [Google Cloud Storage's Documentation](https://cloud.google.com/storage/docs/json_api/v1/objects/insert). |
| Projection | Specifies which properties to return. |

## Example Output

```json theme={"dark"}
{
  "kind": "storage#object",
  "id": string,
  "selfLink": string,
  "mediaLink": string,
  "name": string,
  "bucket": string,
  "generation": "long",
  "metageneration": "long",
  "contentType": string,
  "storageClass": string,
  "size": "unsigned long",
  "softDeleteTime": "datetime",
  "restoreToken": string,
  "hardDeleteTime": "datetime",
  "md5Hash": string,
  "contentEncoding": string,
  "contentDisposition": string,
  "contentLanguage": string,
  "cacheControl": string,
  "crc32c": string,
  "componentCount": integer,
  "etag": string,
  "kmsKeyName": string,
  "temporaryHold": boolean,
  "eventBasedHold": boolean,
  "retentionExpirationTime": "datetime",
  "retention": {
    "retainUntilTime": "datetime",
    "mode": string
  }
  "timeCreated": "datetime",
  "updated": "datetime",
  "timeDeleted": "datetime",
  "timeStorageClassUpdated": "datetime",
  "customTime": "datetime",
  "metadata": {
    (key): string
  },
  "acl": [
    objectAccessControls Resource
  ],
  "owner": {
    "entity": string,
    "entityId": string
  },
  "customerEncryption": {
    "encryptionAlgorithm": string,
    "keySha256": string
  }
}
```

## Workflow Library Example

[Insert Object with Gcp and Send Results Via Email](https://library.blinkops.com/workflows/insert-object-with-gcp-and-send-results-via-email)

![Workflow Library](https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max\&auto=format\&n=ojHYuDeYX5FWuN8a\&q=85\&s=b8af968e71438a9499c3223c9bd29fb2)

Preview this Workflow on desktop

[https://library.blinkops.com/workflows/insert-object-with-gcp-and-send-results-via-email/canvas](https://library.blinkops.com/workflows/insert-object-with-gcp-and-send-results-via-email/canvas)