> ## 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).
</Note>

## Basic Parameters

<div className="integrations-table">
  | 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. <br />For example:<br />`{"name": "myFile"}`                |
  | Object Name       | Name of the object.                                                                                     |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                 | Description                                                                                                                                                                                                                                              |
  | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Cloud KMS Key             | Resource name of the `Cloud KMS key` that will be used to encrypt the object. <br /><br />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.                                                                                                                                                                                                                    |
</div>

## 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)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/insert-object-with-gcp-and-send-results-via-email/canvas" />
</div>