Skip to content

Running an Endpoint

AireGlu endpoints can be invoked with an API call or using other AireGlu features such as Jobs. You can invoke a specific version of an endpoint or always invoke the default version, which can be easily updated at any time.

Setting the default version

When you are creating or editing an endpoint version, you can quickly set it to be the default version for that endpoint in the publish settings panel prior to saving: publish settings default version

You can also manage the default version for an endpoint from the endpoints list:

  1. Select the three dots (more actions) displayed on the endpoint in the endpoints list:

more-actions-default-option

  1. Select the version you want to be the default:

set-default-version

Transaction ID and Correlation ID

Transaction ID

Each endpoint run is associated with a transaction ID. This is automatically generated, or you can pass in your own transaction ID using a query parameter transactionId=<guid>. If your endpoint calls another endpoint the transaction ID will be passed along, allowing calls to be linked together in the Usage Data tab of the Metrics.

You can access the transaction ID query parameter within an endpoint by using Liquid via transactionId.

Correlation ID

Each endpoint run is also associated with a correlation ID. This is commonly used by other AireSuite products to link together steps in a broader journey, beyond a single transaction. Like the transaction ID, the correlation ID will be automatically generated within AireGlu unless one is passed in. To pass in a correlation ID, the endpoint should be called with the x-correlation-id header. This will be automatically applied when called by an AireSuite product. AireGlu will also apply this header when making outgoing HTTP requests.

As with the transaction ID, the correlation ID will be passed on automatically to subsequent endpoint calls. If your endpoint run creates a job, the correlation ID will be applied to the endpoint invoked by that job. The correlation ID will also be passed on to batch invocations.

You can access the correlation ID within an endpoint by using Liquid via correlationId