Tollara icon

Tollara

Tollara marketplace operations: authenticate requests, invoke services, manage async jobs, and report usage

Actions9

Async Callback → Complete

AI-generated

Summary

Report the completion status of an asynchronous Tollara service invocation using the full callback URL from the async invoke response.

Inputs

  • Service Secret (required) — The secret for the Tollara service used for HMAC signing or verification; required for authentication.
  • Callback URL (required) — The full callback URL obtained from the asynchronous invoke response to which the completion report is sent.
  • Request ID (required) — The unique identifier of the asynchronous request to report completion for.
  • Status (required) — The final status of the asynchronous invocation; either 'COMPLETED' or 'FAILED'.
  • Result — A textual result or message describing the outcome of the invocation (optional).
  • Result URL — A URL pointing to the result data or resource (optional).
  • Content Type — The content type of the result (optional).
  • Units — The numeric count of usage units to report for the invocation (defaults to 0).
  • Set API Endpoints — Flag to override default Tollara API URLs; if enabled, provide a custom Usage reporting API URL.
  • Usage reporting API URL — Custom URL for usage reporting API; required if API endpoints are overridden.

Output shape

a list of items, each corresponding to an input item, enriched with completion report result fields

Each output item includes properties indicating whether the completion report succeeded, the HTTP status code and text of the callback response, the callback URL used (possibly rewritten for local usage API), response body, and any network errors encountered.

Examples

Example 1: Reporting async invocation completion

You must provide the 'Callback URL' returned from the asynchronous Tollara service invoke operation, the 'Request ID' of the async call, the 'Status' indicating success or failure, optionally include 'Result' details, 'Result URL', 'Content Type', and 'Units' used. The node sends a signed report to the specified callback URL confirming the completion status and associated data.

Links

Discussion