Generated Mutations Reference ​

This file is auto-generated from the GraphQL schema. Do not edit directly.

Available Mutations ​

• event_id are reused so the receiver sees the same delivery semantics (and can dedupe via event_id if they so choose). Admin-only. Rate-limited 10/min via adminSensitiveRateLimit. | | testPartnerWebhookSubscription | TestPartnerWebhookSubscriptionResult! | Enqueue a synthetic test.ping delivery to an existing subscription. Useful for validating a partner's HMAC verifier on the re-enable flow or after URL change. Admin-only. Rate-limited 10/min via adminSensitiveRateLimit. | | adminCreatePartnerWebhookSubscription | AdminCreatePartnerWebhookSubscriptionResult! | Create a webhook subscription on behalf of a partner organization. Returns the HMAC signing secret exactly once — capture it immediately, it is never readable again. Admin-only and rate-limited. | | deleteWebhook | DeleteWebhookResponse | - | | generateCrsReports | GenerateCrsReportsResponse! | - | | complianceApproveApplicant | ComplianceReviewResult! | - | | complianceRejectApplicant | ComplianceReviewResult! | - | | complianceEscalateApplicant | ComplianceReviewResult! | - | | complianceAddReviewNote | ComplianceReviewResult! | - | | complianceSetRiskLevel | ComplianceReviewResult! | - | | complianceUpgradeToNestedKyb | ComplianceUpgradeResult! | - | | backfillAlchemyTransactions | BackfillAlchemyTransactionsResponse! | - | | cancelFundSubscription | Boolean! | - | | cancelFundRedemption | Boolean! | - | | synchronizeEnzymeVaults | SynchronizeEnzymeVaultsResponse! | - | | signFundAgreement | SignFundAgreementResult! | - | | requestFundSubscriptionSignature | RequestFundSubscriptionSignatureResult! | - | | bookFundSubscription | BookFundSubscriptionResult! | - | | requestFundRedemptionSignature | RequestFundRedemptionSignatureResult! | - | | bookFundRedemption | BookFundRedemptionResult! | - | | processSeriesRollup | ProcessSeriesRollupResponse! | - | | registerBalancerPool | RegisterBalancerPoolResponse! | - | | trackBalancerPool | TrackBalancerPoolResponse! | - | | calculateBalancerLPPrice | CalculateBalancerLPPriceResponse! | - | | refreshBalancerLPPrices | RefreshBalancerLPPricesResponse! | - | | rerunBackfillBalancerPool | RerunBackfillResponse! | - | | snoozeTrainingRequired | SnoozeResult! | - | | sendTrainingReminder | SendTrainingReminderResult! | - | | insertTrainingVersionWithIntegrity | InsertTrainingVersionResult! | - | | requestGoNetworkConnection | GoNetworkConnectionResponse | - | | acceptGoNetworkConnection | GoNetworkActionResponse | - | | revokeGoNetworkConnection | GoNetworkActionResponse | - | | proposeAuditAdjustment | AuditAdjustmentResult! | - | | acceptAuditAdjustment | AcceptAuditAdjustmentResult! | - | | rejectAuditAdjustment | AuditAdjustmentResult! | - | | voidAuditAdjustment | AuditAdjustmentVoidResult! | - | | sendCaseStatusUpdateEmail | SendGridClientResponse | - | | sendCaseSubmittedEmail | SendGridClientResponse | - | | sendKycInviteEmail | SendGridClientResponse | - | | sendSignatureInviteEmail | SendGridClientResponse | - | | sendAccountFundingEmail | SendGridClientResponse | - | | sendBankTransactionEmail | SendGridClientResponse | - | | sendCESRAEmail | SendGridClientResponse | - | | sendStandaloneKycInvite | SendGridClientResponse | - | | AgioOnboardingDocumentGenerate | AgioOnboardingDocumentGenerateResponse! | - | | runFullNavCalculation | NavCalcJob! | - | | approveNavRun | NavCalcJob! | - | | resumeNavRun | NavCalcJob! | - | | cancelNavRun | NavCalcJob! | - | | bitgoSendCoins | BitgoSendCoinsResponse | - | | bitgoCreateAddress | BitgoAddress | - | | bitgoResolveApproval | BitgoApprovalResponse | - | | bitgoSendTransaction | BitgoSendTransactionResponse | - | | bitgoSyncTransaction | BitgoSyncTransactionResponse | - | | bitgoSyncWalletTransactions | BitgoSyncWalletTransactionsResponse | - | | bitgoSyncDigitalWalletTransactions | BitgoSyncDigitalWalletTransactionsResponse | - | | bitgoSyncAllTransactions | BitgoSyncAllTransactionsResponse | - | | bitgoSyncTransactionsForWebhooks | BitgoSyncAllTransactionsResponse | - | | bitgoSyncTokenSupport | BitgoSyncTokenSupportResponse | - | | kms | KMSMutation! | - | | nudgeInvestor | NudgeResponse! | - | | zipFiles | ZipResult | - | | AgioOnboardingDocumentZip | ZipResult | - | | createCardApplication | CardApplicationResponse! | Create a Card application for a user with completed KYC. Requires normal-kyc-level verification. | | freezeCard | CardOperationResponse! | Freeze a Card. Calls the card issuer API and returns immediate response. Card status will be updated via webhook. Requires the user to own the card. | | unfreezeCard | CardOperationResponse! | Unfreeze a Card. Calls the card issuer API and returns immediate response. Card status will be updated via webhook. Requires the user to own the card. | | revealCardSecrets | CardSecretsResponse! | Reveal sensitive card details (PAN, CVC, expiry). Requires the user to own the card. Returns encryptedSecrets - use decryptWithSessionKey from agio-utils to decrypt JSON. | | replaceVirtualCard | CardReplacementResponse! | Replace a virtual Card with a new one. The old card is canceled and a new card is created with new PAN, token, and expiration. The new card inherits spending limits from the old card. Only virtual cards can be replaced - physical cards will return an error. Requires the user to own the card. | | setCardPin | CardPinResponse! | Set or update a Card's PIN. PIN must be 4-12 digits and meet security requirements. Requires the user to own the card. | | getCardPin | CardPinResponse! | Retrieve a Card's PIN. Returns encryptedPin - use decryptWithSessionKey from agio-utils to decrypt. Requires the user to own the card. | | freezeCardByExternalCardId | CardOperationResponse! | Admin-only: Freeze Card by card ID. Bypasses ownership checks. | | unfreezeCardByExternalCardId | CardOperationResponse! | Admin-only: Unfreeze Card by card ID. Bypasses ownership checks. | | revealCardSecretsByExternalCardId | CardSecretsResponse! | Admin-only: Reveal card secrets by card ID. Bypasses ownership checks. Returns encryptedSecrets - use decryptWithSessionKey from agio-utils to decrypt JSON. | | replaceVirtualCardByExternalCardId | CardReplacementResponse! | Admin-only: Replace virtual card by card ID. Bypasses ownership checks. | | setCardPinByExternalCardId | CardPinResponse! | Admin-only: Set card PIN by card ID. Bypasses ownership checks. PIN must be encrypted using encryptPassphraseForTransfer from agio-utils. | | getCardPinByExternalCardId | CardPinResponse! | Admin-only: Get card PIN by card ID. Bypasses ownership checks. Returns encryptedPin - use decryptWithSessionKey from agio-utils to decrypt. | | createCardCorporateApplication | CardCorporateApplicationResponse! | Create a the card issuer Corporate Card application for a company. Requires entity information, initial user, representatives, and UBOs. Website is REQUIRED by the card issuer API. | | validateAddress | AddressValidationResponse! | Validate an address using Google Address Validation API. Returns validation result with confidence level (HIGH, MEDIUM, or LOW). Useful for validating user addresses before creating cards, shipping groups, or billing operations. Cached for 30 days per Google's recommendations. | | validateCardShippingAddress | AddressValidationResponse! | Validate a shipping address via the card issuer's address validation endpoint. Determines whether the card issuer can ship a physical card to this address. Uses Google Address Validation with geocoding fallback — broader country coverage than validateAddress. | | autocompleteAddress | AutocompleteAddressResponse! | Autocomplete address search using Google Places API. Returns address suggestions based on partial input. Useful for address entry forms with typeahead functionality. Results cached for 24 hours. | | resolvePlaceAddress | ResolvePlaceAddressResponse! | Resolve a Google Place ID to a structured address object. Use the placeId returned by autocompleteAddress to fetch precise address fields. | | updateCardNickname | CardOperationResponse! | Update a Card's nickname (display name). Validates: max 26 chars, alphanumeric + spaces + periods + hyphens only. Updates local database. Requires the user to own the card. | | updateCardUserProfile | CardOperationResponse! | Update the card issuer user profile (address and/or phone). Syncs to both the card issuer API and local database. Requires the user to own the card application. | | updateCardCompanyAddress | CardOperationResponse! | Update the card company billing address. Synced to the card processor and persisted locally. Scoped to the customer organization on the partner key (or admin role for internal use). | | updateCardLimit | CardLimitResponse! | Update a Card's spending limit. Updates both the card issuer API and local database. Requires the user to own the card application. | | lockCard | CardOperationResponse! | Lock a Card (alias for freeze). Card cannot be used for transactions. Use unlockCard to restore card functionality. Requires the user to own the card. | | unlockCard | CardOperationResponse! | Unlock a Card (alias for unfreeze). Restores card functionality. Requires the user to own the card. | | cancelCard | CardOperationResponse! | Cancel a Card permanently (irreversible). Card cannot be reactivated after cancellation. Requires the user to own the card. | | createCard | CreateCardResponse! | Create a new Card for an approved application. Supports both virtual and physical cards via cardType discriminator.

• Virtual cards: PIN set immediately, card active after creation
• Physical cards: PIN staged, shipping required, activated when received Requires an approved card application. | | replaceCard | CardReplacementResponse! | Replace an existing Card (for lost/stolen/damaged cards). Creates a new card with new PAN and credentials. The old card is canceled automatically.
• Virtual cards: New card created immediately
• Physical cards: Requires shipping address Requires the user to own the card. | | payInvoiceWithCardBalance | PayInvoiceWithCardBalanceResponse! | Pay an invoice using card balance. Debits the user's card collateral balance and records payment against the invoice. Requires the user to own both the card application and the invoice. | | updateCardLimitByExternalCardId | CardLimitResponse! | Admin-only: Update card limit by card ID. Bypasses ownership checks. | | cancelCardByExternalCardId | CardOperationResponse! | Admin-only: Cancel card by card ID. Bypasses ownership checks. | | createCardByExternalUserId | CreateCardResponse! | Admin-only: Create card for a user by the card issuer user ID. Bypasses ownership checks. | | chargeCard | ChargeCardResponse! | Charge a Card with a fee. Requires card:charge permission. Debits from user's card collateral balance and records the transaction. | | cardWithdraw | CardWithdrawResponse! | Withdraw collateral from a Card smart wallet. Signs the withdrawal with the owner EOA via Alchemy Signer and submits via session key UserOp through the the card issuer coordinator contract. | | runCardReminders | CardReminderRunResponse! | Admin-only: Manually trigger unused card reminder processing. Finds cards with no transactions and sends reminder emails based on the schedule. Use dryRun: true (default) to preview which reminders would be sent. | | createPartnerCustomerOrganization | CreatePartnerCustomerOrganizationResponse! | Partner-only: Create a customer organization managed by the calling partner. Returns an organization_id that can be used with createCardCorporateApplication. | | createCardApplicationForPartnerUser | CardApplicationResponse! | Partner-only: Create a card application for a partner-provisioned card user. Skips Agio-user KYC — the partner is responsible for verifying their end-user's identity. | | createPartnerCardUser | CreatePartnerCardUserResponse! | Partner-only: Provision a cardholder (cardUser) under one of your partner-managed customer organizations. Returns the cardUserId you'll pass to createCardApplicationForPartnerUser. nationalId is KMS-encrypted at rest. Idempotent on (customerOrganizationId, email) — re-running with the same email under the same org returns the existing cardUserId rather than creating a duplicate. | | cardWithdrawForPartner | CardWithdrawForPartnerResponse! | Partner-only: Withdraw USDC collateral from a partner-managed sub-client's collateral contract into the partner's configured Treasury wallet. The recipient is hard-locked to the treasury_wallet_address in the partner's treasury config — callers cannot supply a destination. Routes through the same owner-EOA signing + session-key UserOp path as cardWithdraw, but the recipient is the Treasury wallet, not the sub-client smart wallet. (Admin-curated recipient allowlist is deferred — see plan.md.) | | cardFundSubClientFromTreasury | CardFundSubClientFromTreasuryResponse! | Partner-only: Fund a sub-client's collateral contract from the partner Treasury wallet via a plain ERC-20 transfer (NOT a collateral withdrawal). Enqueues an async job and returns its id. Poll cardFundSubClientStatus(jobId) for the async outcome (see #3665). | | upsertPartnerWithdrawalAllowlist | PartnerWithdrawalAllowlistResponse! | Admin-only: Create or update a partner withdrawal-recipient allowlist entry. Pass id to update an existing entry; omit it to insert. Approved entries are intended to gate cardWithdrawForPartner destinations once the allowlist gate ships; the gate is not yet enforced (pilot hard-locks the recipient to the treasury config). | | multiSendFromWallet | MultiSendFromWalletResponse! | Partner-only: send tokens from a smart wallet to multiple destinations atomically. All transfers must resolve to the same chain. Enqueues immediately; poll multiSendJobStatus. | | mintDealDocumentUploadUrl | DealDocumentUploadTicket! | - | | getDealDocumentDownloadUrl | DealDocumentDownloadTicket! | - | | createTradeSettlement | TradeSettlementResponse! | - | | resolveSettlementTransaction | TradeSettlementResponse! | - | | resolveSwapSettlement | TradeSettlementResponse! | - | | verifySettlement | TradeSettlementResponse! | - | | initiateOutboundSettlement | TradeSettlementResponse! | - | | recordOutboundTransaction | TradeSettlementResponse! | - | | updateSettlementStatus | TradeSettlementResponse! | - | | recordFiatInbound | TradeSettlementResponse! | - | | bridgeToTronQuote | BridgeQuoteResponse | - | | bridgeToTron | BridgeResultResponse | - | | ensureTokenChain | EnsureTokenChainResult! | Ensure a token_chain record exists for a given contract address and network. If the token_chain doesn't exist, fetches metadata from Alchemy and creates the necessary records. | | ensureTokenChainsFromTransactions | EnsureTokenChainsFromTransactionsResult! | Backfill token chains from existing alchemy_transaction records that have contract addresses but no associated token_chain record yet. | | subscribePartnerWebhook | SubscribePartnerWebhookResult! | Register a new webhook subscription for the calling organization. The signingSecret in the result is returned only once — capture it immediately. | | unsubscribePartnerWebhook | UnsubscribePartnerWebhookResult! | Remove a webhook subscription. Subsequent events will not be delivered to its URL. | | rotatePartnerWebhookSecret | RotatePartnerWebhookSecretResult! | Generate a new signing secret for an existing subscription. The previous secret continues to be accepted for 24 hours. | | recomputeFundSpm | RecomputeFundSpmResult! | - |