Skip to main content
New Callback Handler parametersStarting with SGX API Co-signer image version 3.5.0, as well as all versions of AWS Nitro and GCP Confidential Space Co-signer, the following enhancements have been introduced:
  • The Callback Handler’s payload includes the signerId, which represents the API user ID (API key) of the API user handling the request. This is particularly useful in high availability configurations with multiple API Co-signers, as it allows the Callback Handler to identify the specific Co-signer that initiated the request.
Below is the response expected from the Callback Handler for any request. If it does not respond within 30 seconds, Fireblocks fails the request.

Where to see the Callback Handler’s response

  • Transaction sub-status: If the Callback Handler returns REJECT, the transaction is CANCELLED with sub-status REJECTED_BY_USER. If the Co-signer doesn’t get a valid response (invalid JSON, an HTTP error, or no response within 30 seconds), the transaction is FAILED with sub-status AUTHORIZATION_FAILED. See Sub-statuses.
  • Your Callback Handler’s logs: Fireblocks doesn’t store the rejectionReason. To keep a record of each request, the action you returned and the reason, log them in your Callback Handler.
Routing a transaction to a Console user instead of the Co-signerThe Callback Handler cannot hand a transaction signing request over to a Console user. If the Policy rule designates an API user as the signer, or a signer group that includes an API user, the Co-signer signs the transaction without routing it to a Console user.Recommended approach: to have a Console user sign, configure the Policy rule so that the designated signer or signer group does not include the API user. This is a Policy configuration, not a Callback Handler response.Approvals are different from signing. IGNORE is valid for transaction and configuration approval requests only, never for signing requests. Returning IGNORE on an approval request dismisses it without denying it, so a Console user (human approver) can approve it independently. Once approved, the Co-signer still performs the signing if it is the designated signer.