Contact Us 1-800-596-4880

A2A Connector 1.0 Reference

Anypoint Connector for Agent2Agent (A2A) (A2A Connector) provides A2A protocol support for LLM agents, enabling your agents to talk to other agents.

Configurations

Client

The application or AI system that initiates requests and consumes services offered by A2A servers. This allows Mule apps to act as A2A brokers between non A2A “head” agents and A2A “node” agents.

Parameters

Name Type Description Default Value Required

Name

String

Name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types to provide to this configuration.

x

Name

String

ID used to reference this configuration.

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Connection Types

Client Connection
Parameters
Name Type Description Default Value Required

Server Url

String

Base URL of the target A2A server.

x

Request Timeout

Number

Sets the duration to wait for server responses before timing out requests.

30

Request Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Request Timeout field.

SECONDS

Authentication

HttpRequestAuthentication

Default Headers

Object

Default headers.

Tls Context

TLS

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Server

The A2A server acts as a remote agent that exposes an HTTP(S) endpoint and implements the A2A protocol methods for interacting with other AI agents. This allows Mule-based agents to receive and respond to A2A protocol-compliant requests.

Parameters

Name Type Description Default Value Required

Name

String

Name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types to provide to this configuration.

x

Name

String

ID used to reference this configuration.

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Card Json

String

Agent card as a JSON string.

Card Path

String

The location of a file to load the agent card. The file can point to a resource on the classpath or on a disk.

Task History Enabled

Boolean

Set to true to enable retrieval of task history. Task history is stored as message objects.

false

Default Max History Length

Number

Maximum number of task history objects to store.

Task Repository Object Store

ObjectStore

Connection Types

Server Connection
Parameters
Name Type Description Default Value Required

Listener Config

String

Reference to the <http:listener-config> used to expose the inbound endpoint.

x

Agent Path

String

Path at which the agent is available.

x

Tls Context Ref

String

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

A2A Client - Cancel Task

<a2a:cancel-task>

Cancels the task specified by its unique identifier. It’s used to stop a previously initiated task.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Task Id

Any

Unique identifier for the task.

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - Delete Push Notification Config

<a2a:delete-push-notification-config>

Deletes an associated push notification configuration for a task.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Get Push Config Params

Any

Object for fetching the push notification configuration for a task.

x

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - Get Card

<a2a:get-card>

Gets the agent card.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Use Extended Card

Boolean

When true, fetches the authenticated extended agent card instead of the normal agent card.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INVALID_AGENT_CARD

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:UNAUTHORIZED

A2A Client - Get Push Notification Config

<a2a:get-push-notification-config>

Retrieves the current push notification configuration for a specified task.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Get Push Config Params

Any

Object for fetching the push notification configuration for a task.

x

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - Get Task

<a2a:get-task>

Retrieves information about a task based on a provided query. This enables you to fetch the status or details of a task from another agent.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Task Query

Any

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - List Push Notification Configs

<a2a:list-push-notification-configs>

Retrieves the associated push notification configurations for a specified task.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Get Push Config Params

Any

Object for fetching the push notification configuration for a task.

x

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - Send Message

<a2a:send-message>

Sends a message.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Message

Any

Message to send.

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - Send Stream Message

<a2a:send-stream-message>

Sends a message to the A2A agent and establishes an SSE streaming connection to receive real-time status updates, artifacts, and error notifications as the agent processes the request.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Stream Message

Any

Message to send (MessageSendParams schema).

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - Set Push Notification Config

<a2a:set-push-notification-config>

Sets or updates the push notification configuration for a specified task.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Task Push Notification Config

Any

Associates a push notification configuration with a specific task.

x

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Client - Task Resubscribe

<a2a:task-resubscribe>

Reconnects to an existing SSE streaming session for an ongoing task to receive buffered events and continue receiving real-time updates from where the connection was lost.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Task Id Params

Any

Task ID to resubscribe to (TaskIdParams schema).

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Additional Properties

Object

Additional properties to include with the request. Use this field to specify custom key-value pairs that are sent with the A2A connector request. This field is optional and null-safe.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Server - Send Push Notification

<a2a:send-push-notification>

Sends a push notification with the provided task or message payload. This operation allows sending async updates at various stages or steps of a task, not just at the end. The notification message is automatically wrapped in JSON-RPC format. This is a non-blocking operation that uses CompletionCallback for async result handling.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Notification Message

Any

The JSON notification message (task or message object). This value is automatically wrapped in JSON-RPC format.

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Server - Update Task Artifact

<a2a:update-task-artifact>

Updates a task artifact and broadcasts the update to all connected SSE clients.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Artifact Update Content

Any

TaskArtifactUpdateEvent content following A2A specification.

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

A2A Server - Update Task Status

<a2a:update-task-status>

Updates a task status and broadcasts the update to all connected SSE clients.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Status Update Content

Any

TaskStatusUpdateEvent content following A2A specification.

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

For Configurations

Throws

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR

  • A2A:INVALID_PARAMS

  • A2A:INVALID_REQUEST

  • A2A:JSON_RPC_ERROR

  • A2A:METHOD_NOT_FOUND

  • A2A:PARSE_ERROR

  • A2A:PUSH_NOTIFICATION_UNSUPPORTED

  • A2A:REQUEST_TIMEOUT

  • A2A:RETRY_EXHAUSTED

  • A2A:SERVER_ERROR

  • A2A:TASK_NOT_CANCELABLE

  • A2A:TASK_NOT_FOUND

  • A2A:UNAUTHORIZED

  • A2A:UNSUPPORTED_OPERATION

Sources

A2A Server - On Push Notification Set Listener

<a2a:push-notification-config-listener>

Validates the push notification configuration before routing the request to the Task Listener source.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Primary Node Only

Boolean

Primary Node Only specifies whether this source should be executed only on the primary node when running in a cluster.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Redelivery Policy

Defines a policy for processing the redelivery of the same message

Reconnection Strategy

Retry strategy in case of connectivity errors.

Additional Headers

Object

Additional HTTP headers to include with each request.

Authentication

HttpRequestAuthentication

Push notification request timeout

Number

60

Request Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Push notification request timeout field.

SECONDS

Proxy Config

HttpProxyConfig

Proxy configuration.

Output

Type

Any

Attributes Type

For Configurations

A2A Server - Task Listener

<a2a:task-listener>

Allows a Mule application to listen for and receive incoming A2A protocol-compliant requests from other AI agents, enabling the Mule-based agent to act as an A2A server and respond to tasks.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Primary Node Only

Boolean

Determines whether to execute this source on only the primary node when running Mule instances in a cluster.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Response

Any

#[payload]

Response Headers

Object

HTTP response header.

Output

Type

Any

Attributes Type

For Configurations

A2A Server - On Task Stream Listener

<a2a:task-stream-listener>

Server-side listener for streaming task requests. Activated when clients send streaming requests (messages/stream) to trigger server-side flows and enable real-time SSE event delivery.

This source is a prerequisite for applications to support streaming. This source is to be used in conjunction with A2A Server - Task Listener.

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Primary Node Only

Boolean

Determines whether to execute this source on only the primary node when running Mule instances in a cluster.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

String

Attributes Type

For Configurations

Types

TLS

Configures TLS to provide secure communications for the Mule app.

Field Type Description Default Value Required

Enabled Protocols

String

Comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

Comma-separated list of cipher suites enabled for this context.

Trust Store

Configures the TLS truststore.

Key Store

Configures the TLS keystore.

Revocation Check

Configures a revocation checking mechanism.

Truststore

Configures the truststore for TLS.

Field Type Description Default Value Required

Path

String

Path to the truststore. Mule resolves the path relative to the current classpath and file system.

Password

String

Password used to protect the truststore.

Type

String

Type of store.

Algorithm

String

Encryption algorithm that the truststore uses.

Insecure

Boolean

If true, Mule stops performing certificate validations. Setting this to true can make connections vulnerable to attacks.

Keystore

Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.

Field Type Description Default Value Required

Path

String

Path to the keystore. Mule resolves the path relative to the current classpath and file system.

Type

String

Type of store.

Alias

String

Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file.

Key Password

String

Password used to protect the private key.

Password

String

Password used to protect the keystore.

Algorithm

String

Encryption algorithm that the keystore uses.

Standard Revocation Check

Configures standard revocation checks for TLS certificates.

Field Type Description Default Value Required

Only End Entities

Boolean

Which elements to verify in the certificate chain:

  • true

Verify only the last element in the certificate chain.

  • false

Verify all elements in the certificate chain.

Prefer Crls

Boolean

How to check certificate validity:

  • true

Check the Certification Revocation List (CRL) for certificate validity.

  • false

Use the Online Certificate Status Protocol (OCSP) to check certificate validity.

No Fallback

Boolean

Whether to use the secondary method to check certificate validity:

  • true

Use the method that wasn’t specified in the Prefer Crls field (the secondary method) to check certificate validity.

  • false

Don’t use the secondary method to check certificate validity.

Soft Fail

Boolean

What to do if the revocation server can’t be reached or is busy:

  • true

Avoid verification failure.

  • false

Allow the verification to fail.

Custom OCSP Responder

Configures a custom OCSP responder for certification revocation checks.

Field Type Description Default Value Required

Url

String

URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore.

CRL File

Specifies the location of the certification revocation list (CRL) file.

Field Type Description Default Value Required

Path

String

Path to the CRL file.

Reconnection

Configures a reconnection strategy for an operation.

Field Type Description Default Value Required

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

Reconnection strategy to use.

Reconnect

Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.

Field Type Description Default Value Required

Frequency

Number

How often to attempt to reconnect, in milliseconds.

Blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Count

Number

How many reconnection attempts the Mule app can make.

Reconnect Forever

Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.

Field Type Description Default Value Required

Frequency

Number

How often to attempt to reconnect, in milliseconds.

Blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Expiration Policy

Configures an expiration policy strategy.

Field Type Description Default Value Required

Max Idle Time

Number

Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Max Idle Time field.

Response Attributes

In A2A Connector 1.0 and later, this represents the HTTP response attributes for an A2A request. This type encapsulates HTTP response metadata, including status code, headers, and reason phrase, that are sent as part of an A2A protocol response.

Field Type Description Default Value Required

Status Code

Number

HTTP status code of the response.

x

Headers

Object

Map of HTTP headers in the message.

x

Reason Phrase

String

HTTP reason phrase of the response.

Error Mapping

Field Type Description Default Value Required

Source

Enumeration, one of:

  • ANY

  • REDELIVERY_EXHAUSTED

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY

  • SERVER_SECURITY

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED

  • TIMEOUT

Target

String

x

Streaming Response Attributes

In A2A Connector 1.0 and later, this represents the HTTP response attributes for A2A streaming operations (SSE). This specialized type extends Response Attributes with streaming-specific metadata, including information about final events received during the SSE session. This final event information is not related to the A2A protocol final event, but the connector’s.

Field Type Description Default Value Required

Final Event Found

Boolean

Whether a final event was found during SSE session.

false

Status Code

Number

HTTP status code of the response.

x

Headers

Object

Map of HTTP headers in the message.

x

Reason Phrase

String

HTTP reason phrase of the response.

Request Attributes

In A2A Connector 1.0 and later, this represents the HTTP request attributes for an A2A incoming request. This type encapsulates the HTTP request metadata, including query parameters and headers, that are received as part of an A2A protocol request.

Field Type Description Default Value Required

Task Id

String

The ID assigned to this task, either provided by the client or auto-generated by the connector.

x

Context Id

String

The context ID assigned to this task, either provided by the client or auto-generated by the connector.

x

Query Params

Object

The query parameters received in the HTTP request.

x

Headers

Object

The HTTP headers received in the request.

x

Version

String

HTTP version of the request. Former http.version.

x

Scheme

String

HTTP scheme of the request. Former http.scheme.

x

Method

String

HTTP method of the request. Former http.method.

x

Local Address

String

Local host address from the server.

x

Remote Address

String

Remote host address from the sender. Former http.remote.address.

x

Client Certificate

Client certificate (if 2 way TLS is enabled). Former http.client.cert.

Certificate Data

Field Type Description Default Value Required

Basic Constraints

Number

Basic constraints extension value indicating if the certificate can be used to sign other certificates.

Critical Extension OI Ds

Array of String

Object identifiers (OIDs) of critical extensions in the certificate.

Encoded

Binary

The encoded form of the certificate.

Extended Key Usage

Array of String

Extended key usage extension indicating specific purposes for which the certificate public key can be used.

Extensions

Certificate extensions providing additional information about the certificate.

Issuer Alternative Names

Alternative names for the certificate issuer.

Issuer DN

Distinguished name of the certificate issuer.

Issuer Unique ID

Array of Boolean

Unique identifier for the certificate issuer.

Issuer X500 Principal

X.500 principal information for the certificate issuer.

Key Usage

Array of Boolean

Key usage extension indicating the purposes for which the certificate public key can be used.

Name

String

Name associated with the certificate.

Non Critical Extension OI Ds

Array of String

Object identifiers (OIDs) of non-critical extensions in the certificate.

Not After

Date

Expiration date of the certificate.

Not Before

Date

Date from which the certificate is valid.

Public Key

Public key information from the certificate.

Serial Number

Number

Serial number of the certificate.

Serial Number Object

Serial number object containing detailed serial number information.

Sig Alg Name

String

Name of the signature algorithm used to sign the certificate.

Sig Alg OID

String

Object identifier (OID) of the signature algorithm.

Sig Alg Params

Binary

Parameters for the signature algorithm.

Signature

Binary

Digital signature of the certificate.

Subject Alternative Names

Alternative names for the certificate subject.

Subject DN

Distinguished name of the certificate subject.

Subject X500 Principal

X.500 principal information for the certificate subject.

Type

String

Type of the certificate.

Version

Number

Version number of the certificate format.

Certificate Extension

Field Type Description Default Value Required

Criticality

Boolean

Indicates whether the extension is critical. If true, the extension must be processed by the certificate user.

Oid

String

Object identifier (OID) that uniquely identifies the extension type.

Value

Binary

The extension value in its encoded form.

Alternative Name Data

Field Type Description Default Value Required

Name

String

The alternative name value.

Type

Number

The type of alternative name.

Principal Data

Field Type Description Default Value Required

Common Name

String

The common name (CN) component of the distinguished name.

Name

String

The full distinguished name string representation.

X500 Principal Data

Field Type Description Default Value Required

Name

String

The X.500 distinguished name in string format.

Public Key Data

Field Type Description Default Value Required

Algorithm

String

The algorithm used for the public key (for example, RSA, DSA, EC).

Encoded

Binary

The encoded form of the public key.

Modulus

Number

The modulus value for RSA public keys.

Params

Number

Algorithm-specific parameters for the public key.

Public Key

String

The public key value in string representation.

Serial Number Data

Field Type Description Default Value Required

Serial Number

Number

The serial number value of the certificate.

Redelivery Policy

Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.

Field Type Description Default Value Required

Max Redelivery Count

Number

Maximum number of times to process a redelivered request unsuccessfully before returning a REDELIVERY_EXHAUSTED error.

Message Digest Algorithm

String

Secure hashing algorithm to use if the Use Secure Hash field is true. If the payload of the message is a Java object, Mule ignores this value and returns the value that the payload’s hashCode() returned.

Message Identifier

One or more expressions that determine if a message was redelivered. This property can be set only if the Use Secure Hash field is false.

Object Store

ObjectStore

Configures the object store that stores the redelivery counter for each message.

Redelivery Policy Message Identifier

Configures how to identify a redelivered message and how to find out when the message was redelivered.

Field Type Description Default Value Required

Use Secure Hash

Boolean

If true, Mule uses a secure hash algorithm to identify a redelivered message.

Id Expression

String

One or more expressions that determine when a message was redelivered. You can set this property only if the Use Secure Hash field is false.

View on GitHub