> For the complete documentation index, see [llms.txt](https://docs.frends.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.frends.com/tasks/tasks/azure-blob-storage/writeblob.md). # WriteBlob Task version: 2.0.0 Required Frends version: 5.7+ Required .NET version: 8.0 Compatible Agents: Crossplatform Source code: ## Task Parameters {% tabs %} {% tab title="Source" %} | Name | Description | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SourceType : `SourceType` |

Selection of source types.

Possible values:


Default: 1
Example: SourceType.String

| | ContentString : `String` |

Source content in string format.


Default: -
Example: This is test

| | ContentBytes : `Byte[]` |

Source content in byte array.


Default: -
Example: VGhpcyBpcyB0ZXN0

| | Encoding : `FileEncoding` |

Set desired content-encoding.

Defaults to UTF8 BOM.

Possible values:

Defaults to UTF8 BOM.

Defaults to UTF8 BOM.

Defaults to UTF8 BOM.

Defaults to UTF8 BOM.

Defaults to UTF8 BOM.


Default: 0
Example: utf8

| | EnableBOM : `Boolean` |

Enables BOM for UTF-8.


Default: True
Example: -

| | FileEncodingString : `String` |

Content encoding as string. A partial list of possible encodings: .


Default: -
Example: windows-1252

| | {% endtab %} | | {% tab title="Destination" %} | Name | Description | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ContainerName : `String` |

Name of the Azure Blob Storage container.

Task will convert all letters to lowercase.

See more info:


Default: -
Example: examplecontainer

| | BlobName : `String` |

Name of the blob. Blob name can also be folder structure and folders will be created to Blob Storage.

See more info:


Default: -
Example: BlobName.txt; C:\folder\blobName.txt

| | Tags : `Tag[]` |

Tags for the block or append blob.


Default: -
Example: {name, value}

| | CreateContainerIfItDoesNotExist : `Boolean` |

Determines if the container should be created if it does not exist.

See for naming rules.


Default: False
Example: false

| | HandleExistingFile : `HandleExistingFile` |

How the existing blob will be handled.

Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.

Overwrite: The original blob will be deleted before uploading the new one.

Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.

Possible values:

Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.

Overwrite: The original blob will be deleted before uploading the new one.

Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.

Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.

Overwrite: The original blob will be deleted before uploading the new one.

Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.

Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.

Overwrite: The original blob will be deleted before uploading the new one.

Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.


Default: 0
Example: HandleExistingFile.Error

| | Compress : `Boolean` |

Should the string be compressed before sending?


Default: False
Example: -

| | {% endtab %} | | {% tab title="Connection" %} | Name | Description | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | AuthenticationMethod : `ConnectionMethod` |

Defines which connection method should be used for connecting to Azure Blob Storage.

Possible values:


Default: 1
Example: ConnectionMethod.ConnectionString

| | 🗝ConnectionString : `String` |

Connection string to Azure storage.


Default: -
Example: DefaultEndpointsProtocol=https;AccountName=account-name;AccountKey=abc==;EndpointSuffix=core.windows.net

| | ApplicationId : `String` |

Application (Client) ID of Azure AD Application.


Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f

| | TenantId : `String` |

Tenant ID of Azure Tenant.


Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f

| | 🗝ClientSecret : `String` |

Client Secret of Azure AD Application.


Default: -
Example: Password!

| | 🗝SasToken : `String` |

A shared access signature to use when connecting to an Azure storage container.

Grants restricted access rights to Azure Storage resources when combined with URI.


Default: -
Example: sv=2021-04-10\&se=2022-04-10T10%3A431Z\&sr=c\&sp=l\&sig=ZJg983RovE%23ZXI

| | StorageAccountName : `String` |

Name of the Azure storage account.


Default: -
Example: TestStorage

| | Scopes : `String[]` |

Scopes used when authenticating with Arc Managed Identity Cross Tenant.


Default: -
Example: \[api://AzureADTokenExchange/.default]

| | TargetTenantId : `String` |

Target Tenant ID of Azure Tenant.


Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f

| | TargetClientId : `String` |

Target Client ID of Azure Tenant.


Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f

| | {% endtab %} | | {% tab title="Options" %} | Name | Description | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ThrowErrorOnFailure : `Boolean` |

True: Throw an exception.

False: If the error is ignorable, such as when a Blob already exists, the error will be added to the Result.ErrorMessages list instead of stopping the Task.


Default: True
Example: true

| | {% endtab %} | | | {% endtabs %} | | ## Task Result | Name | Description | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Success : `Boolean` |

Operation complete. Operation is seens as completed if an ignorable error has occured and Options.ThrowErrorOnFailure is set to false.
Example: true

| | Info : `String` |

This object contains the source file path and the URL of the blob. If an ignorable error occurs, such as when a blob already exists and Options.ThrowErrorOnFailure is set to false, the URL will be replaced with the corresponding error message.age.
Example: { { c:\temp\examplefile.txt, }, { c:\temp\examplefile2.txt, Blob examplefile2 already exists. } }

| | Uri : `String` | URI of uploaded file. | ## Task Changelog Changelog for Task Frends.AzureBlobStorage.WriteBlob. ### \[2.0.0] - 2026-04-26 #### Changed * Standardized parameter names and validation across all Azure Blob Storage tasks for consistency. ### \[1.3.0] - 2026-01-23 #### Added * Add options to support Arc Managed Identity authentication. ### \[1.2.0] - 2026-01-15 #### Changed * Updated Azure packages to the latest versions: * Azure.Storage.Blobs 12.27.0 * Azure.Identity 1.17.1 ### \[1.1.0] - 2025-10-07 #### Fixed * Change returned info type from 3rd party BlobContentInfo to string with json. ### \[1.0.0] - 2025-01-24 #### Added * Initial implementation of Frends.AzureBlobStorage.WriteBlob. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.frends.com/tasks/tasks/azure-blob-storage/writeblob.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.