> 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/http/requestbytes.md). # RequestBytes Task version: 1.5.0 Required Frends version: 5.5+ Required .NET version: 6.0 Compatible Agents: Crossplatform Source code: ## Task Parameters {% tabs %} {% tab title="Input" %} | Name | Description | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Method : `Method` |

The HTTP Method to be used with the request.

Possible values:


Default: 0
Example: GET

| | Url : `String` |

The URL with protocol and path. You can include query parameters directly in the url.


Default:
Example:

| | Message : `String` |

The message text to be sent with the request.


Default: -
Example: { "Body": "Message" }

| | Headers : `Header[]` |

List of HTTP headers to be added to the request.


Default: -
Example: Name: Header, Value: HeaderValue

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

Method of authenticating request

Possible values:


Default: -
Example: OAuth

| | Username : `String` |

If WindowsAuthentication is selected you should use domain\username


Default: -
Example: Username

| | 🗝Password : `String` |

Password for the user


Default: -
Example: Password123

| | 🗝Token : `String` |

Bearer token to be used for request. Token will be added as Authorization header.


Default: -
Example: Token123

| | UseProxy : `Boolean` |

Whether to route requests through a proxy server. When set to true, the ProxyUrl must be provided.


Default: False
Example: false

| | ProxyUrl : `String` |

Proxy URL used for the request.


Default: -
Example:

| | ProxyUsername : `String` |

Username for proxy authentication. Leave empty if proxy does not require authentication.

Both username and password must be provided together or left empty.


Default: -
Example: Username

| | 🗝ProxyPassword : `String` |

Password for proxy authentication. Leave empty if proxy does not require authentication.

Both username and password must be provided together or left empty.


Default: -
Example: Password123

| | ClientCertificateSource : `CertificateSource` |

Specifies where the Client Certificate should be loaded from.

Possible values:


Default: 0
Example: File

| | ClientCertificateFilePath : `String` |

Applicable only when Certificate Source is "File".

Path to the Client Certificate, pfx (pkcs12) files are recommended. For other supported formats, see


Default: -
Example: domain\path

| | ClientCertificateInBase64 : `String` |

Applicable only when Certificate Source is "String".

Client certificate bytes as a base64 encoded string, pfx (pkcs12) format is recommended. For other supported formats, see


Default: -
Example: domain\path

| | 🗝ClientCertificateKeyPhrase : `String` |

Applicable only when Certificate Source is "File" or "String".

Key phrase (password) to access the certificate data


Default: -
Example: string value

| | CertificateThumbprint : `String` |

Applicable only when Certificate Source is "CertificateStore".

Thumbprint for using client certificate authentication.


Default: -
Example: thumbprint

| | CertificateStoreLocation : `CertificateStoreLocation` |

Applicable only when Certificate Source is "CertificateStore".

Store location for the certificate.

Possible values:

Store location for the certificate.

Store location for the certificate.


Default: 0
Example: CurrentUser

| | LoadEntireChainForCertificate : `Boolean` |

Should the entire certificate chain be loaded from the certificate store and included in the request. Only valid when using Certificate Store as the Certificate Source


Default: True
Example: true

| | ConnectionTimeoutSeconds : `Int32` |

Timeout in seconds to be used for the connection and operation.


Default: 30
Example: 30

| | FollowRedirects : `Boolean` |

If FollowRedirects is set to false, all responses with an HTTP status code from 300 to 399 is returned to the application.


Default: True
Example: true

| | AllowInvalidCertificate : `Boolean` |

Do not throw an exception on certificate error.


Default: -
Example: true

| | AllowInvalidResponseContentTypeCharSet : `Boolean` |

Some Api's return faulty content-type charset header. This setting overrides the returned charset.


Default: -
Example: true

| | ThrowExceptionOnErrorResponse : `Boolean` |

Throw exception if return code of request is not successfull


Default: -
Example: true

| | AutomaticCookieHandling : `Boolean` |

If set to false, cookies must be handled manually. Defaults to true.


Default: True
Example: true

| | HttpProtocolVersion : `HttpVersion` |

HTTP protocol version to use for requests. HTTP/1.1 is the default and most compatible option.

Possible values:


Default: 0
Example: Http11

| | SslProtocolVersion : `SslVersion` |

SSL/TLS protocol version to use for secure connections. Default lets the OS decide, which matches previous behavior.

Use Tls12 or Tls12And13 if the server requires a specific version.

Possible values:

Use Tls12 or Tls12And13 if the server requires a specific version.

Use Tls12 or Tls12And13 if the server requires a specific version.

Use Tls12 or Tls12And13 if the server requires a specific version.

Use Tls12 or Tls12And13 if the server requires a specific version.


Default: 0
Example: Default

| | {% endtab %} | | | {% endtabs %} | | ## Task Result | Name | Description | | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | Body : `Byte[]` |

Body of response
Example: {"id": "abcdefghijkl123456789", "success": true, "errors": \[]}

| | BodySizeInMegaBytes : `Double` |

Body size of response
Example: 10.0

| | ContentType : `MediaTypeHeaderValue` |

Header type of response
Example: 10.0

| | Headers : `Dictionary` |

Headers of response
Example: {\[ "content-type": "application/json", ... ]}

| | StatusCode : `Int32` |

Statuscode of response
Example: 200

| ## Task Changelog Changelog for Task Frends.HTTP.RequestBytes. ### \[1.5.0] - 2026-05-13 #### Added * Added UseProxy, ProxyUrl, ProxyUsername, ProxyPassword, HttpProtocolVersion, and SslProtocolVersion options with proxy handler and protocol configuration support. ### \[1.4.0] - 2026-03-02 #### Added * Added CertificateStoreLocation option to allow selection between CurrentUser and LocalMachine certificate stores when using certificate authentication. ### \[1.3.0] - 2025-10-10 #### Changed * Changed the return type of RequestBytes from Task to Task ### \[1.2.0] - 2025-03-25 #### Changed * Update packages: Newtonsoft.Json 12.0.1 -> 13.0.3 System.ComponentModel.Annotations 4.7.0 -> 5.0.0 System.Runtime.Caching 7.0.0 -> 9.0.3 coverlet.collector 3.1.0 -> 6.0.4 Microsoft.NET.Test.Sdk 16.7.0 -> 17.13.0 MSTest.TestAdapter 2.1.2 -> 3.8.3 MSTest.TestFramework 2.1.2 -> 3.8.3 nunit 3.12.0 -> 4.3.2 NUnit3TestAdapter 3.17.0 -> 5.0.0 RichardSzalay.MockHttp 6.0.0 -> 7.0.0 xunit.extensibility.core 2.4.2 -> 2.9.3 ### \[1.1.0] - 2024-12-30 #### Changed * Descriptions of ClientCertificate suboptions includes clearer information about usage in terms of different types of ClientCertificate. ### \[1.0.1] - 2024-01-17 #### Fixed * Fixed issues which CodeQL found in the codebase. Fixed Code Coverage ### \[1.0.0] - 2023-01-27 #### Added * Initial implementation of Frends.HTTP.Request. --- # 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/http/requestbytes.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.