From b89ba3372cfd620b5ae33743a8bf3f7445985d9e Mon Sep 17 00:00:00 2001 From: jottakka Date: Fri, 10 Oct 2025 17:03:56 -0300 Subject: [PATCH] [MOAR][SquareUP] Adding square up toolkit (#596) Adding square up toolkit --------- Co-authored-by: Francisco Liberal --- docker/toolkits.txt | 1 + toolkits/squareup_api/.pre-commit-config.yaml | 18 + toolkits/squareup_api/.ruff.toml | 44 + toolkits/squareup_api/LICENSE | 21 + toolkits/squareup_api/Makefile | 54 + .../arcade_squareup_api/__init__.py | 0 .../arcade_squareup_api/tools/__init__.py | 5013 +++++++++++++++++ .../wrapper_tools/AcceptDispute.json | 105 + .../wrapper_tools/AddGroupToCustomer.json | 137 + .../wrapper_tools/CancelApprovedPayment.json | 105 + .../wrapper_tools/CancelLoyaltyPromotion.json | 137 + .../wrapper_tools/CancelSubscription.json | 105 + .../wrapper_tools/CancelTerminalAction.json | 105 + .../wrapper_tools/CancelTerminalCheckout.json | 105 + .../wrapper_tools/CancelTerminalRefund.json | 105 + .../DeleteBookingCustomAttribute.json | 137 + ...eleteBookingCustomAttributeDefinition.json | 105 + .../wrapper_tools/DeleteBreakType.json | 105 + .../wrapper_tools/DeleteCatalogObject.json | 105 + .../DeleteCustomerCustomAttribute.json | 137 + ...leteCustomerCustomAttributeDefinition.json | 105 + .../wrapper_tools/DeleteCustomerGroup.json | 105 + .../wrapper_tools/DeleteCustomerProfile.json | 137 + .../wrapper_tools/DeleteDraftInvoice.json | 138 + .../DeleteLocationCustomAttribute.json | 105 + .../wrapper_tools/DeleteLoyaltyReward.json | 105 + .../DeleteMerchantCustomAttribute.json | 105 + .../DeleteOrderCustomAttribute.json | 137 + .../DeleteOrderCustomAttributeDefinition.json | 105 + .../wrapper_tools/DeletePaymentLink.json | 106 + .../DeleteSubscriptionAction.json | 137 + .../wrapper_tools/DeleteTimecard.json | 105 + .../DeleteWebhookSubscription.json | 101 + .../wrapper_tools/DisableEventsSearch.json | 67 + .../wrapper_tools/DisablePaymentCard.json | 101 + .../wrapper_tools/DismissTerminalAction.json | 101 + .../DismissTerminalCheckout.json | 101 + .../wrapper_tools/DismissTerminalRefund.json | 101 + .../wrapper_tools/EnableEventsForSearch.json | 67 + .../wrapper_tools/FetchPaymentList.json | 561 ++ .../wrapper_tools/FetchSpecificRefund.json | 105 + .../wrapper_tools/GetAccountDisputes.json | 187 + .../wrapper_tools/GetBankAccountDetails.json | 105 + .../GetBankAccountDetailsById.json | 105 + .../GetBookingCustomAttribute.json | 201 + .../GetBookingCustomAttributes.json | 137 + .../wrapper_tools/GetBookingList.json | 297 + .../GetBusinessBookingProfile.json | 71 + .../GetCashDrawerShiftDetails.json | 137 + .../GetCustomerCustomAttributeDefinition.json | 137 + .../wrapper_tools/GetCustomerDetails.json | 105 + .../GetDisputeEvidenceMetadata.json | 137 + .../wrapper_tools/GetGiftCardDetails.json | 105 + .../wrapper_tools/GetInventoryAdjustment.json | 105 + .../wrapper_tools/GetInventoryTransfer.json | 105 + .../GetLocationCustomAttribute.json | 201 + .../GetMerchantCustomAttribute.json | 201 + .../wrapper_tools/GetMerchantDetails.json | 105 + .../wrapper_tools/GetPaymentDetails.json | 105 + .../wrapper_tools/GetPayoutDetails.json | 101 + .../wrapper_tools/GetPayoutList.json | 307 + .../wrapper_tools/GetScheduledShift.json | 105 + .../GetSquareMerchantSettings.json | 72 + .../wrapper_tools/GetTeamMemberWage.json | 105 + .../wrapper_tools/GetTerminalAction.json | 105 + .../wrapper_tools/GetTerminalRefund.json | 105 + .../wrapper_tools/ListBankAccounts.json | 169 + .../ListBookingCustomAttributes.json | 201 + .../wrapper_tools/ListBusinessBreakTypes.json | 169 + .../ListCashDrawerShiftEvents.json | 201 + .../wrapper_tools/ListCashDrawerShifts.json | 271 + .../wrapper_tools/ListCatalogItems.json | 169 + ...istCustomerCustomAttributeDefinitions.json | 137 + .../ListCustomerCustomAttributes.json | 201 + .../wrapper_tools/ListCustomerGroups.json | 137 + .../wrapper_tools/ListCustomerSegments.json | 137 + .../wrapper_tools/ListDeviceCodes.json | 215 + .../wrapper_tools/ListDisputeEvidence.json | 137 + .../wrapper_tools/ListEventTypes.json | 101 + .../wrapper_tools/ListGiftCardActivities.json | 329 ++ .../wrapper_tools/ListGiftCards.json | 233 + .../wrapper_tools/ListInvoices.json | 169 + .../wrapper_tools/ListJobsForSeller.json | 105 + .../ListLocationBookingProfiles.json | 137 + ...istLocationCustomAttributeDefinitions.json | 177 + .../ListLocationCustomAttributes.json | 241 + .../wrapper_tools/ListLoyaltyPromotions.json | 211 + ...istMerchantCustomAttributeDefinitions.json | 177 + .../ListMerchantCustomAttributes.json | 241 + .../wrapper_tools/ListMerchantDevices.json | 207 + .../ListOrderCustomAttributeDefinitions.json | 177 + .../ListOrderCustomAttributes.json | 241 + .../wrapper_tools/ListPaymentLinks.json | 137 + .../wrapper_tools/ListPaymentRefunds.json | 431 ++ .../wrapper_tools/ListPayoutEntries.json | 203 + .../wrapper_tools/ListSellerLocations.json | 71 + .../wrapper_tools/ListSquareCustomers.json | 245 + .../wrapper_tools/ListSquareOnlineSites.json | 71 + .../wrapper_tools/ListSubscriptionEvents.json | 169 + .../ListTeamMemberBookingProfiles.json | 201 + .../wrapper_tools/ListTeamMemberWages.json | 169 + .../wrapper_tools/ListWebhookEventTypes.json | 101 + .../ListWebhookSubscriptions.json | 203 + .../ListWorkweekConfigurations.json | 137 + .../wrapper_tools/RemoveDisputeEvidence.json | 137 + .../RemoveGroupFromCustomer.json | 137 + .../RemoveInvoiceAttachment.json | 137 + .../RemoveLocationCustomAttribute.json | 137 + .../RemoveMerchantCustomAttribute.json | 137 + .../RemoveSquareOnlineSnippet.json | 105 + .../wrapper_tools/RetrieveBooking.json | 105 + ...rieveBookingCustomAttributeDefinition.json | 137 + .../wrapper_tools/RetrieveBreakType.json | 105 + .../wrapper_tools/RetrieveCardDetails.json | 101 + .../wrapper_tools/RetrieveCardList.json | 235 + .../wrapper_tools/RetrieveCatalogInfo.json | 71 + .../wrapper_tools/RetrieveCatalogItem.json | 201 + .../RetrieveCheckoutLocationSettings.json | 105 + .../RetrieveCustomerCustomAttribute.json | 201 + .../wrapper_tools/RetrieveCustomerGroup.json | 105 + .../RetrieveCustomerSegment.json | 105 + .../wrapper_tools/RetrieveDeviceCode.json | 105 + .../wrapper_tools/RetrieveDeviceInfo.json | 105 + .../wrapper_tools/RetrieveDisputeDetails.json | 105 + .../wrapper_tools/RetrieveInventoryCount.json | 169 + .../RetrieveInventoryPhysicalCount.json | 105 + .../wrapper_tools/RetrieveInvoiceById.json | 105 + .../wrapper_tools/RetrieveJobDetails.json | 105 + .../RetrieveLocationBookingProfile.json | 105 + ...ieveLocationCustomAttributeDefinition.json | 137 + .../RetrieveLocationDetails.json | 105 + .../wrapper_tools/RetrieveLoyaltyAccount.json | 105 + .../wrapper_tools/RetrieveLoyaltyProgram.json | 105 + .../RetrieveLoyaltyPromotion.json | 137 + .../wrapper_tools/RetrieveLoyaltyReward.json | 105 + .../RetrieveMerchantCustomAttribute.json | 137 + .../wrapper_tools/RetrieveMerchantInfo.json | 105 + .../wrapper_tools/RetrieveOrderById.json | 105 + .../RetrieveOrderCustomAttribute.json | 201 + ...etrieveOrderCustomAttributeDefinition.json | 137 + .../wrapper_tools/RetrievePaymentLink.json | 105 + .../wrapper_tools/RetrieveSiteSnippet.json | 105 + .../wrapper_tools/RetrieveSubscription.json | 137 + .../RetrieveTeamMemberBookingProfile.json | 105 + .../RetrieveTeamMemberDetails.json | 105 + .../RetrieveTeamMemberWageSetting.json | 105 + .../RetrieveTerminalCheckout.json | 105 + .../wrapper_tools/RetrieveTimecard.json | 105 + .../wrapper_tools/RetrieveTokenStatus.json | 67 + .../wrapper_tools/RetrieveVendorInfo.json | 105 + .../RetrieveWebhookSubscription.json | 101 + .../wrapper_tools/SubmitDisputeEvidence.json | 105 + toolkits/squareup_api/pyproject.toml | 61 + toolkits/squareup_api/tests/__init__.py | 0 154 files changed, 25668 insertions(+) create mode 100644 toolkits/squareup_api/.pre-commit-config.yaml create mode 100644 toolkits/squareup_api/.ruff.toml create mode 100644 toolkits/squareup_api/LICENSE create mode 100644 toolkits/squareup_api/Makefile create mode 100644 toolkits/squareup_api/arcade_squareup_api/__init__.py create mode 100644 toolkits/squareup_api/arcade_squareup_api/tools/__init__.py create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AcceptDispute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AddGroupToCustomer.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelApprovedPayment.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelLoyaltyPromotion.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelSubscription.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalAction.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalCheckout.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalRefund.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttributeDefinition.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBreakType.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCatalogObject.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttributeDefinition.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerGroup.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerProfile.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteDraftInvoice.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLocationCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLoyaltyReward.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteMerchantCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttributeDefinition.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeletePaymentLink.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteSubscriptionAction.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteTimecard.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteWebhookSubscription.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisableEventsSearch.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisablePaymentCard.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalAction.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalCheckout.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalRefund.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/EnableEventsForSearch.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchPaymentList.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchSpecificRefund.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetAccountDisputes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetailsById.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttributes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingList.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBusinessBookingProfile.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCashDrawerShiftDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerCustomAttributeDefinition.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetDisputeEvidenceMetadata.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetGiftCardDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryAdjustment.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryTransfer.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetLocationCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPaymentDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutList.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetScheduledShift.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetSquareMerchantSettings.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTeamMemberWage.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalAction.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalRefund.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBankAccounts.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBookingCustomAttributes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBusinessBreakTypes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShiftEvents.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShifts.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCatalogItems.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributeDefinitions.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerGroups.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerSegments.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDeviceCodes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDisputeEvidence.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListEventTypes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCardActivities.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCards.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListInvoices.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListJobsForSeller.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationBookingProfiles.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributeDefinitions.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLoyaltyPromotions.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributeDefinitions.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantDevices.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributeDefinitions.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentLinks.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentRefunds.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPayoutEntries.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSellerLocations.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareCustomers.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareOnlineSites.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSubscriptionEvents.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberBookingProfiles.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberWages.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookEventTypes.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookSubscriptions.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWorkweekConfigurations.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveDisputeEvidence.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveGroupFromCustomer.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveInvoiceAttachment.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveLocationCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveMerchantCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveSquareOnlineSnippet.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBooking.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBookingCustomAttributeDefinition.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBreakType.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardList.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogInfo.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogItem.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCheckoutLocationSettings.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerGroup.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerSegment.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceCode.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceInfo.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDisputeDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryCount.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryPhysicalCount.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInvoiceById.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveJobDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationBookingProfile.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationCustomAttributeDefinition.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyAccount.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyProgram.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyPromotion.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyReward.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantInfo.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderById.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttribute.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttributeDefinition.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrievePaymentLink.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSiteSnippet.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSubscription.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberBookingProfile.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberDetails.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberWageSetting.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTerminalCheckout.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTimecard.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTokenStatus.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveVendorInfo.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveWebhookSubscription.json create mode 100644 toolkits/squareup_api/arcade_squareup_api/wrapper_tools/SubmitDisputeEvidence.json create mode 100644 toolkits/squareup_api/pyproject.toml create mode 100644 toolkits/squareup_api/tests/__init__.py diff --git a/docker/toolkits.txt b/docker/toolkits.txt index 19d596ba..b75b9c25 100644 --- a/docker/toolkits.txt +++ b/docker/toolkits.txt @@ -1,4 +1,5 @@ arcade-box-api arcade-slack-api arcade-stripe-api +arcade-squareup-api arcade-xero-api diff --git a/toolkits/squareup_api/.pre-commit-config.yaml b/toolkits/squareup_api/.pre-commit-config.yaml new file mode 100644 index 00000000..2108505b --- /dev/null +++ b/toolkits/squareup_api/.pre-commit-config.yaml @@ -0,0 +1,18 @@ +files: ^.*/squareup_api/.* +repos: + - repo: https://github.com/pre-commit/pre-commit-hooks + rev: "v4.4.0" + hooks: + - id: check-case-conflict + - id: check-merge-conflict + - id: check-toml + - id: check-yaml + - id: end-of-file-fixer + - id: trailing-whitespace + + - repo: https://github.com/astral-sh/ruff-pre-commit + rev: v0.6.7 + hooks: + - id: ruff + args: [--fix] + - id: ruff-format diff --git a/toolkits/squareup_api/.ruff.toml b/toolkits/squareup_api/.ruff.toml new file mode 100644 index 00000000..9519fe6c --- /dev/null +++ b/toolkits/squareup_api/.ruff.toml @@ -0,0 +1,44 @@ +target-version = "py310" +line-length = 100 +fix = true + +[lint] +select = [ + # flake8-2020 + "YTT", + # flake8-bandit + "S", + # flake8-bugbear + "B", + # flake8-builtins + "A", + # flake8-comprehensions + "C4", + # flake8-debugger + "T10", + # flake8-simplify + "SIM", + # isort + "I", + # mccabe + "C90", + # pycodestyle + "E", "W", + # pyflakes + "F", + # pygrep-hooks + "PGH", + # pyupgrade + "UP", + # ruff + "RUF", + # tryceratops + "TRY", +] + +[lint.per-file-ignores] +"**/tests/*" = ["S101"] + +[format] +preview = true +skip-magic-trailing-comma = false diff --git a/toolkits/squareup_api/LICENSE b/toolkits/squareup_api/LICENSE new file mode 100644 index 00000000..dfbb8b76 --- /dev/null +++ b/toolkits/squareup_api/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2025, Arcade AI + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/toolkits/squareup_api/Makefile b/toolkits/squareup_api/Makefile new file mode 100644 index 00000000..86da492a --- /dev/null +++ b/toolkits/squareup_api/Makefile @@ -0,0 +1,54 @@ +.PHONY: help + +help: + @echo "🛠️ github Commands:\n" + @grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}' + +.PHONY: install +install: ## Install the uv environment and install all packages with dependencies + @echo "🚀 Creating virtual environment and installing all packages using uv" + @uv sync --active --all-extras --no-sources + @if [ -f .pre-commit-config.yaml ]; then uv run --no-sources pre-commit install; fi + @echo "✅ All packages and dependencies installed via uv" + +.PHONY: install-local +install-local: ## Install the uv environment and install all packages with dependencies with local Arcade sources + @echo "🚀 Creating virtual environment and installing all packages using uv" + @uv sync --active --all-extras + @if [ -f .pre-commit-config.yaml ]; then uv run pre-commit install; fi + @echo "✅ All packages and dependencies installed via uv" +.PHONY: build +build: clean-build ## Build wheel file using poetry + @echo "🚀 Creating wheel file" + uv build + +.PHONY: clean-build +clean-build: ## clean build artifacts + @echo "🗑️ Cleaning dist directory" + rm -rf dist + +.PHONY: test +test: ## Test the code with pytest + @echo "🚀 Testing code: Running pytest" + @uv run --no-sources pytest -W ignore -v --cov --cov-config=pyproject.toml --cov-report=xml + +.PHONY: coverage +coverage: ## Generate coverage report + @echo "coverage report" + @uv run --no-sources coverage report + @echo "Generating coverage report" + @uv run --no-sources coverage html + +.PHONY: bump-version +bump-version: ## Bump the version in the pyproject.toml file by a patch version + @echo "🚀 Bumping version in pyproject.toml" + uv version --no-sources --bump patch + +.PHONY: check +check: ## Run code quality tools. + @if [ -f .pre-commit-config.yaml ]; then\ + echo "🚀 Linting code: Running pre-commit";\ + uv run --no-sources pre-commit run -a;\ + fi + @echo "🚀 Static type checking: Running mypy" + @uv run --no-sources mypy --config-file=pyproject.toml diff --git a/toolkits/squareup_api/arcade_squareup_api/__init__.py b/toolkits/squareup_api/arcade_squareup_api/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/toolkits/squareup_api/arcade_squareup_api/tools/__init__.py b/toolkits/squareup_api/arcade_squareup_api/tools/__init__.py new file mode 100644 index 00000000..93c09469 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/tools/__init__.py @@ -0,0 +1,5013 @@ +"""Arcade Starter Tools for Squareup + +DO NOT EDIT THIS MODULE DIRECTLY. + +THIS MODULE WAS AUTO-GENERATED BY TRANSPILING THE API WRAPPER TOOL JSON DEFINITIONS +IN THE ../wrapper_tools DIRECTORY INTO PYTHON CODE. ANY CHANGES TO THIS MODULE WILL +BE OVERWRITTEN BY THE TRANSPILER. +""" + +import asyncio +from typing import Annotated, Any + +import httpx +from arcade_tdk import ToolContext, tool +from arcade_tdk.auth import OAuth2 + +# Retry configuration +INITIAL_RETRY_DELAY = 0.5 # seconds + +HTTP_CLIENT = httpx.AsyncClient( + timeout=httpx.Timeout(60.0, connect=10.0), + limits=httpx.Limits(max_keepalive_connections=20, max_connections=100), + transport=httpx.AsyncHTTPTransport(retries=3), + http2=True, + follow_redirects=True, +) + + +def remove_none_values(data: dict[str, Any]) -> dict[str, Any]: + return {k: v for k, v in data.items() if v is not None} + + +async def make_request( + url: str, + method: str, + params: dict[str, Any] | None = None, + headers: dict[str, Any] | None = None, + data: dict[str, Any] | None = None, + max_retries: int = 3, +) -> httpx.Response: + """Make an HTTP request with retry logic for 5xx server errors.""" + for attempt in range(max_retries): + try: + response = await HTTP_CLIENT.request( + url=url, + method=method, + params=params, + headers=headers, + data=data, + ) + response.raise_for_status() + except httpx.HTTPStatusError as e: + # Only retry on 5xx server errors + if e.response.status_code >= 500 and attempt < max_retries - 1: + # Exponential backoff: 0.5s, 1s, 2s + await asyncio.sleep(INITIAL_RETRY_DELAY * (2**attempt)) + continue + # Re-raise for 4xx errors or if max retries reached + raise + except httpx.RequestError: + # Don't retry request errors (network issues are handled by transport) + raise + else: + return response + + # This should never be reached, but satisfies type checker + raise httpx.RequestError("Maximum retries exceeded") # noqa: TRY003 + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def retrieve_token_status( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveTokenStatus'."]: + """Retrieve the status of an OAuth or personal access token. + + This tool checks the status of a Square OAuth access token or a personal access token. It should be called to verify if a token is active or expired. Ensure the token is included in the Authorization header as 'Bearer ACCESS_TOKEN'.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/oauth2/token/status", + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["BANK_ACCOUNTS_READ"])) +async def list_bank_accounts( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "The pagination cursor from a previous call to fetch the next set of bank account results.", + ] = None, + max_bank_accounts_limit: Annotated[ + int | None, + "Specify the maximum number of bank accounts to return. The largest supported limit is 1000.", # noqa: E501 + ] = None, + location_id_filter: Annotated[ + str | None, "Optional filter to retrieve bank accounts for a specified location ID only." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListBankAccounts'."]: + """Fetch a list of bank accounts linked to a Square account. + + Call this tool to retrieve all bank accounts associated with a Square account. Useful for checking account details or managing linked bank accounts.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bank-accounts", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "limit": max_bank_accounts_limit, + "location_id": location_id_filter, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["BANK_ACCOUNTS_READ"])) +async def get_bank_account_details_by_id( + context: ToolContext, + v1_bank_account_id: Annotated[ + str, + "Connect V1 ID of the desired BankAccount. A unique string identifier to retrieve specific bank account details.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetBankAccountByV1Id'."]: + """Retrieve bank account details using V1 ID. + + Use this tool to get detailed information about a bank account by providing the V1 bank account ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bank-accounts/by-v1-id/{v1_bank_account_id}".format( # noqa: UP032 + v1_bank_account_id=v1_bank_account_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["BANK_ACCOUNTS_READ"])) +async def get_bank_account_details( + context: ToolContext, + bank_account_identifier: Annotated[ + str, "Square-issued ID of the specific bank account to retrieve details for." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetBankAccount'."]: + """Retrieve details of a Square account's bank account. + + Fetches detailed information about a specific bank account linked to a Square account using the bank account ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bank-accounts/{bank_account_id}".format( # noqa: UP032 + bank_account_id=bank_account_identifier + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_READ"])) +async def get_booking_list( + context: ToolContext, + results_per_page_limit: Annotated[ + int | None, + "The maximum number of results to display per page in the response. Accepts an integer value.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "The pagination cursor from the previous response for fetching the next page of results. Leave unset for the first page.", # noqa: E501 + ] = None, + specific_customer_id: Annotated[ + str | None, + "The specific customer for whom to retrieve bookings. If not set, retrieves bookings for all customers.", # noqa: E501 + ] = None, + team_member_id: Annotated[ + str | None, + "Specify the team member ID to retrieve bookings for. If not set, retrieves bookings for all team members.", # noqa: E501 + ] = None, + specific_location_id: Annotated[ + str | None, + "Specify the location ID to retrieve bookings for that location only. If not set, bookings for all locations are retrieved.", # noqa: E501 + ] = None, + earliest_start_time: Annotated[ + str | None, + "The RFC 3339 timestamp for the earliest booking start time. Defaults to current time if not set.", # noqa: E501 + ] = None, + latest_start_time: Annotated[ + str | None, + "The RFC 3339 timestamp for the latest acceptable start time of bookings. Defaults to 31 days after `start_at_min` if not set.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListBookings'."]: + """Retrieve a collection of bookings. + + Use this tool to get a collection of bookings from the Squareup service. Relevant permissions (OAuth scope) are needed: `APPOINTMENTS_READ` for buyer-level and `APPOINTMENTS_ALL_READ` along with `APPOINTMENTS_READ` for seller-level permissions.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings", + method="GET", + params=remove_none_values({ + "limit": results_per_page_limit, + "cursor": pagination_cursor, + "customer_id": specific_customer_id, + "team_member_id": team_member_id, + "location_id": specific_location_id, + "start_at_min": earliest_start_time, + "start_at_max": latest_start_time, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_BUSINESS_SETTINGS_READ"])) +async def get_business_booking_profile( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveBusinessBookingProfile'."]: + """Retrieve seller's booking profile details. + + Use this tool to get detailed information about a seller's booking profile. Call this tool when you need to provide or display booking-related information for a seller.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/business-booking-profile", + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_READ"])) +async def get_booking_custom_attributes( + context: ToolContext, + maximum_results_per_page: Annotated[ + int | None, + "Advisory maximum results per page. Minimum is 1, maximum is 100, default is 20.", + ] = None, + pagination_cursor: Annotated[ + str | None, "Cursor for retrieving the next page of results from a previous response." + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'ListBookingCustomAttributeDefinitions'." +]: + """Retrieve all custom attribute definitions for bookings. + + Use this tool to get all custom attribute definitions associated with bookings. It requires appropriate OAuth scopes for buyer or seller level permissions.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/custom-attribute-definitions", + method="GET", + params=remove_none_values({"limit": maximum_results_per_page, "cursor": pagination_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_WRITE"])) +async def delete_booking_custom_attribute_definition( + context: ToolContext, + custom_attribute_definition_key: Annotated[ + str, "The unique key of the custom attribute definition to be deleted." + ], +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'DeleteBookingCustomAttributeDefinition'." +]: + """Deletes a bookings custom attribute definition. + + Use to delete a custom attribute definition for bookings. Requires specific OAuth scopes depending on permission level: `APPOINTMENTS_WRITE` for buyer-level or both `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for seller-level. Seller-level calls require an Appointments Plus or Premium subscription.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_definition_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_READ"])) +async def retrieve_booking_custom_attribute_definition( + context: ToolContext, + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute definition to retrieve. If not the definition owner, use the qualified key.", # noqa: E501 + ], + custom_attribute_version: Annotated[ + int | None, + "The version of the custom attribute definition for consistent reads. If the version is too high, a `BAD_REQUEST` error occurs.", # noqa: E501 + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'RetrieveBookingCustomAttributeDefinition'." +]: + """Retrieve a booking's custom attribute definition. + + Use this tool to obtain the definition of a custom attribute for bookings. Appropriate OAuth scope permissions are required, either buyer-level (`APPOINTMENTS_READ`) or seller-level (`APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ`).""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_key + ), + method="GET", + params=remove_none_values({"version": custom_attribute_version}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_BUSINESS_SETTINGS_READ"])) +async def list_location_booking_profiles( + context: ToolContext, + maximum_results_per_page: Annotated[ + int | None, + "The maximum number of booking profiles to retrieve in one page of the response.", + ] = None, + pagination_cursor: Annotated[ + str | None, + "Use this to provide the pagination cursor from the previous response to get the next set of results. Leave unset for the first page.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListLocationBookingProfiles'."]: + """Lists location booking profiles of a seller. + + Use this tool to retrieve a list of all the booking profiles associated with a seller's locations from Squareup.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/location-booking-profiles", + method="GET", + params=remove_none_values({"limit": maximum_results_per_page, "cursor": pagination_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_BUSINESS_SETTINGS_READ"])) +async def retrieve_location_booking_profile( + context: ToolContext, + location_id: Annotated[ + str, "The unique ID of the location whose booking profile is to be retrieved." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLocationBookingProfile'."]: + """Retrieve a seller's location booking profile. + + Use this tool to obtain the booking profile details for a specific seller's location by providing the location ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/location-booking-profiles/{location_id}".format( # noqa: UP032 + location_id=location_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_BUSINESS_SETTINGS_READ"])) +async def list_team_member_booking_profiles( + context: ToolContext, + max_results_per_page: Annotated[ + int | None, + "The maximum number of results to return in a paged response. Useful for controlling pagination size.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "The pagination cursor for returning the next page of results. Leave empty to get the first page.", # noqa: E501 + ] = None, + filter_by_location_id: Annotated[ + str | None, "Specify the location ID to filter team members enabled at that location." + ] = None, + include_only_bookable_team_members: Annotated[ + bool | None, + "Set to true to include only bookable team members in the result; false to include all members.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListTeamMemberBookingProfiles'."]: + """Lists booking profiles for team members. + + Call this tool to retrieve booking profiles for all team members, useful for managing schedules and appointments.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/team-member-booking-profiles", + method="GET", + params=remove_none_values({ + "bookable_only": include_only_bookable_team_members, + "limit": max_results_per_page, + "cursor": pagination_cursor, + "location_id": filter_by_location_id, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_BUSINESS_SETTINGS_READ"])) +async def retrieve_team_member_booking_profile( + context: ToolContext, + team_member_id: Annotated[ + str, + "The unique ID of the team member whose booking profile you want to retrieve. Must be a valid string identifier.", # noqa: E501 + ], +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'RetrieveTeamMemberBookingProfile'." +]: + """Retrieve a team member's booking profile details. + + Use this tool to access the booking profile of a specific team member by their ID.""" + response = await make_request( + url="https://connect.squareup.com/v2/bookings/team-member-booking-profiles/{team_member_id}".format( # noqa: UP032 + team_member_id=team_member_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_READ"])) +async def retrieve_booking( + context: ToolContext, + booking_id: Annotated[str, "The unique identifier for the booking to retrieve details."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveBooking'."]: + """Retrieve details of a specific booking. + + Use this tool to get information about a particular booking using its ID. Appropriate OAuth scopes are required depending on whether buyer or seller permissions are needed.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/{booking_id}".format(booking_id=booking_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_READ"])) +async def list_booking_custom_attributes( + context: ToolContext, + booking_identifier: Annotated[ + str, + "The unique identifier for the target booking whose custom attributes you want to list.", + ], + maximum_results_per_page: Annotated[ + int | None, + "The maximum number of results to return per page, between 1 and 100. Default is 20.", + ] = None, + pagination_cursor: Annotated[ + str | None, + "Cursor for retrieving the next page of results from a previous call to the endpoint.", + ] = None, + include_custom_attribute_definitions: Annotated[ + bool | None, + "Set to true to include custom attribute definition details, such as name and data type, in the response. Default is false.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListBookingCustomAttributes'."]: + """Lists custom attributes for a specific booking. + + Use this tool to retrieve the custom attributes associated with a specific booking. Ensure the appropriate OAuth permissions (`APPOINTMENTS_READ` for buyer-level or `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for seller-level) are set before calling this endpoint.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/{booking_id}/custom-attributes".format( # noqa: UP032 + booking_id=booking_identifier + ), + method="GET", + params=remove_none_values({ + "limit": maximum_results_per_page, + "cursor": pagination_cursor, + "with_definitions": include_custom_attribute_definitions, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_WRITE"])) +async def delete_booking_custom_attribute( + context: ToolContext, + booking_id: Annotated[ + str, "The ID of the target booking from which the custom attribute will be deleted." + ], + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute to delete. It must match the key of a custom attribute definition in the Square seller account. Use the qualified key if not the definition owner.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteBookingCustomAttribute'."]: + """Deletes a custom attribute from a booking. + + Use this tool to remove a custom attribute from a specific booking. Appropriate OAuth permissions are required: 'APPOINTMENTS_WRITE' for buyer-level and 'APPOINTMENTS_ALL_WRITE' with 'APPOINTMENTS_WRITE' for seller-level. Seller must be subscribed to Appointments Plus or Premium.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/{booking_id}/custom-attributes/{key}".format( # noqa: UP032 + booking_id=booking_id, key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["APPOINTMENTS_READ"])) +async def get_booking_custom_attribute( + context: ToolContext, + target_booking_id: Annotated[ + str, "The ID of the target booking to retrieve its custom attribute." + ], + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute to retrieve, matching the custom attribute definition in the Square seller account. Use the qualified key if not the definition owner.", # noqa: E501 + ], + custom_attribute_version: Annotated[ + int | None, + "The current version of the custom attribute for consistent reads. An integer value required to ensure up-to-date data.", # noqa: E501 + ] = None, + include_custom_attribute_definition: Annotated[ + bool | None, + "Set to true to include the custom attribute's definition, such as name and data type, in the response. Defaults to false.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveBookingCustomAttribute'."]: + """Retrieve a custom attribute for a specific booking. + + Use this tool to get a custom attribute associated with a given booking, using either buyer- or seller-level permissions.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/bookings/{booking_id}/custom-attributes/{key}".format( # noqa: UP032 + booking_id=target_booking_id, key=custom_attribute_key + ), + method="GET", + params=remove_none_values({ + "with_definition": include_custom_attribute_definition, + "version": custom_attribute_version, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def retrieve_card_list( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "A string value representing a pagination cursor to retrieve the next set of results. Use this to continue from the last retrieved set.", # noqa: E501 + ] = None, + filter_by_customer_id: Annotated[ + str | None, + "Limit results to cards associated with the specified customer. By default, all merchant-owned cards are returned.", # noqa: E501 + ] = None, + filter_by_reference_id: Annotated[ + str | None, + "Filter results to include only cards associated with the specified reference ID.", + ] = None, + card_sort_order: Annotated[ + str | None, + "Defines the sort order for the card creation date. Use 'ASC' for ascending or 'DESC' for descending. Defaults to 'ASC'.", # noqa: E501 + ] = None, + include_disabled_cards: Annotated[ + bool | None, + "Set to true to include disabled cards in the results. By default, only enabled cards are returned.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCards'."]: + """Retrieve a list of cards owned by the account. + + The tool retrieves up to 25 cards associated with the account making the request. It should be used when there is a need to access card information for the account.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/cards", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "customer_id": filter_by_customer_id, + "include_disabled": include_disabled_cards, + "reference_id": filter_by_reference_id, + "sort_order": card_sort_order, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def retrieve_card_details( + context: ToolContext, + card_identifier: Annotated[str, "Unique ID for the card to retrieve its details."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveCard'."]: + """Retrieve details for a specific card using its ID. + + This tool retrieves information about a specific card identified by its ID, allowing users to access details such as metadata and status.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/cards/{card_id}".format(card_id=card_identifier), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def disable_payment_card( + context: ToolContext, + payment_card_id: Annotated[str, "Unique ID for the card to be disabled."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DisableCard'."]: + """Disable a payment card to prevent charges. + + Use this tool to disable a payment card, stopping any further updates or charges. Disabling an already disabled card is permitted but will not have any additional effect.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/cards/{card_id}/disable".format( # noqa: UP032 + card_id=payment_card_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CASH_DRAWER_READ"])) +async def list_cash_drawer_shifts( + context: ToolContext, + location_identifier: Annotated[ + str, "The unique identifier for the location to query for cash drawer shifts." + ], + sort_order_for_listing: Annotated[ + str | None, + "Specifies the order for listing cash drawer shifts by their opened_at field. Use 'ASC' for ascending or 'DESC' for descending. Defaults to 'ASC'.", # noqa: E501 + ] = None, + query_start_time: Annotated[ + str | None, "The inclusive start time for the query on opened_at, in ISO 8601 format." + ] = None, + exclusive_end_date: Annotated[ + str | None, + "The exclusive end time of the query on opened_at, specified in ISO 8601 format, to define the endpoint for the cash drawer shift search.", # noqa: E501 + ] = None, + result_limit: Annotated[ + int | None, + "Specifies the number of cash drawer shift events per results page. Defaults to 200, with a maximum of 1000.", # noqa: E501 + ] = None, + next_page_cursor: Annotated[ + str | None, "Opaque cursor for fetching the next page of results, used for pagination." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCashDrawerShifts'."]: + """Retrieve cash drawer shift details for a location and date range. + + This tool provides details for all the cash drawer shifts for a specified location within a given date range. It should be called when cash drawer shift information is needed, such as start and end times, cash amounts, or other shift details for financial tracking and auditing purposes.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/cash-drawers/shifts", + method="GET", + params=remove_none_values({ + "location_id": location_identifier, + "sort_order": sort_order_for_listing, + "begin_time": query_start_time, + "end_time": exclusive_end_date, + "limit": result_limit, + "cursor": next_page_cursor, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CASH_DRAWER_READ"])) +async def get_cash_drawer_shift_details( + context: ToolContext, + location_identifier: Annotated[ + str, + "The unique identifier for the location to retrieve cash drawer shifts from. Ensure this matches the location set up in Squareup.", # noqa: E501 + ], + cash_drawer_shift_id: Annotated[ + str, "The unique identifier for the cash drawer shift to retrieve details for." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveCashDrawerShift'."]: + """Get summary details for a specific cash drawer shift. + + Use this tool to retrieve detailed information about a specific cash drawer shift, including relevant data about its transactions and status.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/cash-drawers/shifts/{shift_id}".format( # noqa: UP032 + shift_id=cash_drawer_shift_id + ), + method="GET", + params=remove_none_values({"location_id": location_identifier}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CASH_DRAWER_READ"])) +async def list_cash_drawer_shift_events( + context: ToolContext, + location_identifier: Annotated[ + str, + "The ID of the location to list cash drawer shifts for. This should be a valid location ID registered within the system.", # noqa: E501 + ], + cash_drawer_shift_id: Annotated[ + str, "The unique ID of the cash drawer shift for which events are to be retrieved." + ], + page_size_limit: Annotated[ + int | None, "Number of events to return per page, default is 200, maximum is 1000." + ] = None, + pagination_cursor: Annotated[ + str | None, "Opaque string to fetch the next page of results for cash drawer shift events." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCashDrawerShiftEvents'."]: + """Retrieve events for a specific cash drawer shift. + + This tool retrieves a paginated list of events for a specific cash drawer shift. It is useful for tracking activities and occurrences related to a particular shift.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/cash-drawers/shifts/{shift_id}/events".format( # noqa: UP032 + shift_id=cash_drawer_shift_id + ), + method="GET", + params=remove_none_values({ + "location_id": location_identifier, + "limit": page_size_limit, + "cursor": pagination_cursor, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ITEMS_READ"])) +async def retrieve_catalog_info( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'CatalogInfo'."]: + """Retrieve Square Catalog API details and batch size limits. + + Use this tool to get information about the Square Catalog API, including batch size limits for catalog operations.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/catalog/info", + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ITEMS_READ"])) +async def list_catalog_items( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "The pagination cursor from the previous response. Leave empty for the initial request. Defaults to a page size of 100 results.", # noqa: E501 + ] = None, + catalog_object_types: Annotated[ + str | None, + "A comma-separated list of catalog object types to retrieve. Defaults to returning top-level types if unspecified.", # noqa: E501 + ] = None, + catalog_version: Annotated[ + int | None, + "Specify the version of the catalog objects to retrieve. Use to access historical versions. Default retrieves the current version.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCatalog'."]: + """Retrieve a list of catalog objects by type. + + This tool retrieves a list of all catalog objects of specified types, such as ITEM, ITEM_VARIATION, MODIFIER, etc., excluding deleted items. It's useful for accessing and managing various components of a catalog in the Square ecosystem.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/catalog/list", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "types": catalog_object_types, + "catalog_version": catalog_version, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ITEMS_WRITE"])) +async def delete_catalog_object( + context: ToolContext, + catalog_object_id: Annotated[ + str, + "The ID of the catalog object, including its child objects, to be deleted. This is a cascading deletion.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteCatalogObject'."]: + """Deletes a catalog object and its children by ID. + + This tool deletes a catalog object by its ID, including all its child objects, ensuring that only one delete request is processed at a time per seller account. It should be called when you want to permanently remove a catalog item and its variations.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/catalog/object/{object_id}".format( # noqa: UP032 + object_id=catalog_object_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ITEMS_READ"])) +async def retrieve_catalog_item( + context: ToolContext, + catalog_object_id: Annotated[ + str, "The ID of the catalog object to retrieve. Use a unique string to specify the object." + ], + catalog_version: Annotated[ + int | None, + "Specify the version number of the catalog to retrieve objects from a specific historical catalog version. If omitted, retrieves the current version.", # noqa: E501 + ] = None, + include_related_objects: Annotated[ + bool | None, + "Include additional objects related to the requested items in the response if set to `true`. This helps in displaying complete information for immediate use.", # noqa: E501 + ] = None, + include_category_path_to_root: Annotated[ + bool | None, + "Set to 'true' to include the `path_to_root` list for each returned category instance. This path starts with the immediate parent category and ends with the root category. If the category is top-level, the `path_to_root` list is empty and not returned.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveCatalogObject'."]: + """Fetch detailed catalog item information by ID. + + Use this tool to obtain complete details about a specific catalog item, including its variations, modifier lists, and applicable taxes, by providing the item ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/catalog/object/{object_id}".format( # noqa: UP032 + object_id=catalog_object_id + ), + method="GET", + params=remove_none_values({ + "include_related_objects": include_related_objects, + "catalog_version": catalog_version, + "include_category_path_to_root": include_category_path_to_root, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def list_square_customers( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "A pagination cursor to retrieve the next set of customer profiles. Use a cursor from a previous query call to fetch subsequent results.", # noqa: E501 + ] = None, + maximum_results_per_page: Annotated[ + int | None, + "Specify the maximum number of customer profiles to return in a single page. Must be between 1 and 100, inclusive.", # noqa: E501 + ] = None, + customer_sorting_field: Annotated[ + str | None, + "Specify how customer profiles should be sorted. Options are `DEFAULT` or `CREATED_AT`. Default is `DEFAULT`.", # noqa: E501 + ] = None, + customer_sort_order: Annotated[ + str | None, + "Specifies whether to sort customers in ascending ('ASC') or descending ('DESC') order. Default is 'ASC'.", # noqa: E501 + ] = None, + include_total_customer_count: Annotated[ + bool | None, + "Set to true to include the total count of customers in the response. The default is false.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCustomers'."]: + """Retrieve customer profiles from a Square account. + + Use this tool to obtain a list of customer profiles linked to a Square account. This is helpful for managing and analyzing customer data. Customer profiles may take some time to update, especially during network issues.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "limit": maximum_results_per_page, + "sort_field": customer_sorting_field, + "sort_order": customer_sort_order, + "count": include_total_customer_count, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def list_customer_custom_attribute_definitions( + context: ToolContext, + maximum_results_per_page: Annotated[ + int | None, + "The maximum number of results to return in a paged response. Accepts values from 1 to 100, with a default of 20.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "Cursor for retrieving the next page of results. Obtain this from a previous response.", + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'ListCustomerCustomAttributeDefinitions'." +]: + """Retrieve customer custom attribute definitions for a Square seller. + + Use this tool to list all customer-related custom attribute definitions for a Square seller account. It returns all visible custom attribute definitions to the requesting application, including those set by other applications.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/custom-attribute-definitions", + method="GET", + params=remove_none_values({"limit": maximum_results_per_page, "cursor": pagination_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_WRITE"])) +async def delete_customer_custom_attribute_definition( + context: ToolContext, + custom_attribute_key: Annotated[ + str, + "The unique key of the custom attribute definition you wish to delete from the seller account.", # noqa: E501 + ], +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'DeleteCustomerCustomAttributeDefinition'." +]: + """Delete a customer custom attribute definition for a seller account. + + This tool deletes a customer-related custom attribute definition from a Square seller's account. It will also remove the related custom attribute from all customer profiles in the seller's Customer Directory. Only the definition owner can perform this action.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def get_customer_custom_attribute_definition( + context: ToolContext, + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute definition to retrieve. Use the qualified key if not the definition owner.", # noqa: E501 + ], + custom_attribute_version: Annotated[ + int | None, + "Current version of the attribute definition for consistent reads. Returns specified or higher version data. Error if version is too high.", # noqa: E501 + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'RetrieveCustomerCustomAttributeDefinition'." +]: + """Retrieve a customer's custom attribute definition from Square. + + Fetches a customer-related custom attribute definition from a Square seller account. This should be called to get definitions where visibility is either 'READ_ONLY' or 'READ_WRITE_VALUES', including seller-defined custom fields.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_key + ), + method="GET", + params=remove_none_values({"version": custom_attribute_version}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def list_customer_groups( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "A pagination cursor to retrieve the next set of customer groups. Used to continue from the last retrieved page.", # noqa: E501 + ] = None, + maximum_results_per_page: Annotated[ + int | None, + "The maximum number of results to return per page, between 1 and 50. Defaults to 50.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCustomerGroups'."]: + """Retrieve the list of customer groups for a business. + + Use this tool to access all customer groups associated with a business. Useful for managing or displaying customer segmentation and categories.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/groups", + method="GET", + params=remove_none_values({"cursor": pagination_cursor, "limit": maximum_results_per_page}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_WRITE"])) +async def delete_customer_group( + context: ToolContext, + customer_group_id: Annotated[str, "The ID of the customer group to delete."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteCustomerGroup'."]: + """Deletes a specified customer group by ID.""" + response = await make_request( + url="https://connect.squareup.com/v2/customers/groups/{group_id}".format( # noqa: UP032 + group_id=customer_group_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def retrieve_customer_group( + context: ToolContext, + customer_group_id: Annotated[ + str, "The ID of the customer group you want to retrieve details for." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveCustomerGroup'."]: + """Retrieve details of a specific customer group using its ID. + + This tool retrieves information about a specific customer group identified by a given group ID. It is useful for accessing details about customer segmentation for targeting or analysis purposes.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/groups/{group_id}".format( # noqa: UP032 + group_id=customer_group_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def list_customer_segments( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, "A pagination cursor for retrieving the next set of customer segment results." + ] = None, + max_results_per_page: Annotated[ + int | None, + "Maximum number of results to return per page. Must be between 1 and 50. Default is 50. If outside this range, an error is returned.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCustomerSegments'."]: + """Retrieve the list of customer segments for a business. + + Call this tool to obtain the customer segments associated with a business. This can be useful for understanding customer classifications and targeting specific groups in marketing or service strategies.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/segments", + method="GET", + params=remove_none_values({"cursor": pagination_cursor, "limit": max_results_per_page}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def retrieve_customer_segment( + context: ToolContext, + customer_segment_id: Annotated[ + str, "The Square-issued ID of the customer segment to retrieve." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveCustomerSegment'."]: + """Retrieve details of a specific customer segment. + + Use this tool to obtain information about a customer segment identified by a `segment_id`.""" + response = await make_request( + url="https://connect.squareup.com/v2/customers/segments/{segment_id}".format( # noqa: UP032 + segment_id=customer_segment_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_WRITE"])) +async def delete_customer_profile( + context: ToolContext, + customer_identifier: Annotated[str, "The unique identifier of the customer to be deleted."], + customer_profile_version: Annotated[ + int | None, + "The current version of the customer profile. Used for optimistic concurrency control.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteCustomer'."]: + """Deletes a customer profile from a business. + + Use this tool to delete a customer profile, especially if created by merging existing profiles. The unique customer ID is required for deletion.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/{customer_id}".format( # noqa: UP032 + customer_id=customer_identifier + ), + method="DELETE", + params=remove_none_values({"version": customer_profile_version}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def get_customer_details( + context: ToolContext, + customer_id: Annotated[ + str, + "The unique ID of the customer to retrieve details for. Used to access specific customer information.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveCustomer'."]: + """Retrieve details for a specific customer. + + Use this tool to get detailed information about a specific customer by their ID. Ideal for when you need to access customer profiles or verify customer details.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/{customer_id}".format( # noqa: UP032 + customer_id=customer_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def list_customer_custom_attributes( + context: ToolContext, + customer_profile_id: Annotated[ + str, "The ID of the customer profile for which to list custom attributes." + ], + result_limit: Annotated[ + int | None, + "Maximum number of results for a single response. Accepts values 1-100, with a default of 20.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "The pagination cursor from the previous response to continue retrieving results.", + ] = None, + include_custom_attribute_definitions: Annotated[ + bool | None, + "Indicate whether to include custom attribute definitions such as name, description, and data type details in the response. Default is false.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListCustomerCustomAttributes'."]: + """Retrieve custom attributes for a customer profile. + + This tool lists the custom attributes associated with a specified customer profile. It can also retrieve custom attribute definitions if specified. It returns all attributes visible to the requesting application, including those with read-only or read-write visibility owned by other applications.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/{customer_id}/custom-attributes".format( # noqa: UP032 + customer_id=customer_profile_id + ), + method="GET", + params=remove_none_values({ + "limit": result_limit, + "cursor": pagination_cursor, + "with_definitions": include_custom_attribute_definitions, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_WRITE"])) +async def delete_customer_custom_attribute( + context: ToolContext, + customer_profile_id: Annotated[ + str, "The ID of the target customer profile for which the custom attribute will be deleted." + ], + custom_attribute_key: Annotated[ + str, + "The key identifying the custom attribute to delete, matching the definition in the Square account. Use the qualified key if the application isn't the definition owner.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteCustomerCustomAttribute'."]: + """Delete a custom attribute from a customer profile. + + Deletes a custom attribute from a customer profile, ensuring the visibility setting is `VISIBILITY_READ_WRITE_VALUES` for attributes owned by other applications.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/{customer_id}/custom-attributes/{key}".format( # noqa: UP032 + customer_id=customer_profile_id, key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_READ"])) +async def retrieve_customer_custom_attribute( + context: ToolContext, + customer_profile_id: Annotated[ + str, "The ID of the target customer profile you want to retrieve a custom attribute for." + ], + custom_attribute_key: Annotated[ + str, + "The unique key of the custom attribute to retrieve, matching the definition in the Square seller account. Use the qualified key if the app is not the definition owner.", # noqa: E501 + ], + custom_attribute_version: Annotated[ + int | None, + "The current version of the custom attribute for consistent reads. If higher than available, returns an error.", # noqa: E501 + ] = None, + include_custom_attribute_definition: Annotated[ + bool | None, + "Set to true to include the custom attribute definition in the response, including details like name, description, and data type.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveCustomerCustomAttribute'."]: + """Retrieve a custom attribute for a customer profile. + + Use this tool to get a custom attribute associated with a customer. Optionally, retrieve the attribute definition and ensure proper visibility settings for attributes owned by other applications.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/{customer_id}/custom-attributes/{key}".format( # noqa: UP032 + customer_id=customer_profile_id, key=custom_attribute_key + ), + method="GET", + params=remove_none_values({ + "with_definition": include_custom_attribute_definition, + "version": custom_attribute_version, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_WRITE"])) +async def remove_group_from_customer( + context: ToolContext, + customer_id: Annotated[ + str, + "The unique ID of the customer to remove from the specified group. Provide as a string.", + ], + customer_group_id: Annotated[ + str, "The ID of the customer group from which the customer will be removed." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RemoveGroupFromCustomer'."]: + """Removes a group membership from a customer. + + Use this tool to remove a customer's membership in a specific group by providing the customer's ID and the group's ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/{customer_id}/groups/{group_id}".format( # noqa: UP032 + customer_id=customer_id, group_id=customer_group_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["CUSTOMERS_WRITE"])) +async def add_group_to_customer( + context: ToolContext, + customer_id: Annotated[ + str, + "The unique identifier for the customer to be added to a group. It must match an existing customer ID.", # noqa: E501 + ], + customer_group_id: Annotated[ + str, + "The ID of the customer group to which the customer will be added. This should be a valid group ID.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'AddGroupToCustomer'."]: + """Add a customer to a specific group. + + Use this tool to assign a specified customer to a particular group by providing the customer's ID and the group's ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/customers/{customer_id}/groups/{group_id}".format( # noqa: UP032 + customer_id=customer_id, group_id=customer_group_id + ), + method="PUT", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DEVICES_READ"])) +async def list_merchant_devices( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, "A pagination cursor from a previous call to retrieve the next set of results." + ] = None, + result_sort_order: Annotated[ + str | None, + "Specifies whether to list results from oldest to newest ('ASC') or newest to oldest ('DESC'). Default is 'DESC'.", # noqa: E501 + ] = None, + results_per_page: Annotated[ + int | None, "The number of device results to return in a single API call." + ] = None, + filter_by_location_id: Annotated[ + str | None, "Return devices only at the specified location." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListDevices'."]: + """Retrieve a list of merchant's connected devices. + + Call this tool to obtain a list of devices associated with a merchant, specifically Terminal API devices, using the Squareup service.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/devices", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "sort_order": result_sort_order, + "limit": results_per_page, + "location_id": filter_by_location_id, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DEVICE_CREDENTIAL_MANAGEMENT"])) +async def list_device_codes( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "A pagination cursor from a previous call, used to retrieve the next set of results.", + ] = None, + filter_by_location_id: Annotated[ + str | None, + "Specify a location to return only its DeviceCodes. Leave empty to return codes from all locations.", # noqa: E501 + ] = None, + filter_by_product_type: Annotated[ + str | None, + "Specify a product type to target specific DeviceCodes. Use 'TERMINAL_API' or leave empty for all types.", # noqa: E501 + ] = None, + device_code_status: Annotated[ + str | None, + "Specifies the status of DeviceCodes to return. Options: UNKNOWN, UNPAIRED, PAIRED, EXPIRED. Returns PAIRED and UNPAIRED if empty.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListDeviceCodes'."]: + """Retrieve all device codes for the merchant. + + This tool retrieves all device codes associated with a merchant account on Square. It should be called when there's a need to list or manage the devices linked to a merchant.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/devices/codes", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "location_id": filter_by_location_id, + "product_type": filter_by_product_type, + "status": device_code_status, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DEVICE_CREDENTIAL_MANAGEMENT"])) +async def retrieve_device_code( + context: ToolContext, + device_code_id: Annotated[ + str, "The unique identifier for the device code to retrieve details from Squareup." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetDeviceCode'."]: + """Retrieve device code details by ID. + + Use this tool to get details of a device code using the associated ID from Squareup.""" + response = await make_request( + url="https://connect.squareup.com/v2/devices/codes/{id}".format(id=device_code_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DEVICES_READ"])) +async def retrieve_device_info( + context: ToolContext, + device_unique_id: Annotated[ + str, "The unique identifier for the device you want to retrieve details for." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetDevice'."]: + """Retrieve device information using a device ID. + + Use this tool to obtain details about a specific device by providing its device ID. It retrieves information related to the device, which can be useful for managing or reviewing devices in a system.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/devices/{device_id}".format( # noqa: UP032 + device_id=device_unique_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DISPUTES_READ"])) +async def get_account_disputes( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, "A cursor for retrieving the next set of dispute results from a previous query." + ] = None, + dispute_states_filter: Annotated[ + str | None, + "Filter disputes by their states. Options include 'INQUIRY_EVIDENCE_REQUIRED', 'INQUIRY_PROCESSING', 'INQUIRY_CLOSED', 'EVIDENCE_REQUIRED', 'PROCESSING', 'WON', 'LOST', 'ACCEPTED'.", # noqa: E501 + ] = None, + location_identifier: Annotated[ + str | None, + "The ID of the location to return a list of disputes for. If not provided, returns disputes for all locations.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListDisputes'."]: + """Fetches disputes associated with an account. + + Use this tool to retrieve all disputes linked to a specific account. This can help in tracking and managing any disputes that have arisen.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/disputes", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "states": dispute_states_filter, + "location_id": location_identifier, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DISPUTES_READ"])) +async def retrieve_dispute_details( + context: ToolContext, + dispute_id: Annotated[str, "The unique ID of the dispute to retrieve details for."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveDispute'."]: + """Retrieve details about a specific dispute. + + Use this tool to get detailed information about a particular dispute, including the reasons and status of the dispute.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/disputes/{dispute_id}".format(dispute_id=dispute_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DISPUTES_WRITE"])) +async def accept_dispute( + context: ToolContext, + dispute_id: Annotated[ + str, + "The unique identifier for the dispute that needs to be accepted. This must match the ID given by Square for the specific dispute.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'AcceptDispute'."]: + """Accepts the loss on a dispute, updating the state to ACCEPTED. + + This tool accepts the loss on a dispute by updating its state to ACCEPTED. Square processes the disputed amount, returning it to the cardholder and debiting the seller's Square account or associated bank account if funds are insufficient.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/disputes/{dispute_id}/accept".format( # noqa: UP032 + dispute_id=dispute_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DISPUTES_READ"])) +async def list_dispute_evidence( + context: ToolContext, + dispute_id: Annotated[ + str, "The unique identifier of the dispute for which evidence is being requested." + ], + pagination_cursor: Annotated[ + str | None, + "A pagination cursor to retrieve the next set of results for the original query.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListDisputeEvidence'."]: + """Retrieve evidence related to a specific dispute. + + Use this tool to obtain a list of all evidence associated with a particular dispute by specifying the dispute ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/disputes/{dispute_id}/evidence".format( # noqa: UP032 + dispute_id=dispute_id + ), + method="GET", + params=remove_none_values({"cursor": pagination_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DISPUTES_WRITE"])) +async def remove_dispute_evidence( + context: ToolContext, + dispute_id: Annotated[ + str, "The unique identifier of the dispute from which evidence should be removed." + ], + evidence_id_to_remove: Annotated[ + str, "The ID of the evidence you want to remove from the dispute." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteDisputeEvidence'."]: + """Removes specified evidence from a dispute. + + Use this tool to remove evidence from a dispute. This can be called when it's necessary to retract evidence previously submitted for a dispute. The bank will not be informed of the removed evidence.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/disputes/{dispute_id}/evidence/{evidence_id}".format( # noqa: UP032 + dispute_id=dispute_id, evidence_id=evidence_id_to_remove + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DISPUTES_READ"])) +async def get_dispute_evidence_metadata( + context: ToolContext, + dispute_id: Annotated[str, "The unique ID of the dispute to retrieve its evidence metadata."], + evidence_id: Annotated[ + str, + "The ID of the evidence you wish to retrieve metadata for. Ensure correct ID is provided to access the specific evidence details.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveDisputeEvidence'."]: + """Retrieve metadata for specified dispute evidence. + + Call this tool to obtain metadata of dispute evidence using a given dispute ID and evidence ID. Ensure to maintain a copy of any evidence uploaded as it cannot be downloaded later.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/disputes/{dispute_id}/evidence/{evidence_id}".format( # noqa: UP032 + dispute_id=dispute_id, evidence_id=evidence_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["DISPUTES_WRITE"])) +async def submit_dispute_evidence( + context: ToolContext, + dispute_id: Annotated[ + str, + "The unique identifier for the dispute to which you are submitting evidence. You need this ID to ensure the evidence is attached to the correct dispute case.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'SubmitEvidence'."]: + """Submit evidence to a cardholder's bank for a dispute. + + This tool is used to submit evidence related to a dispute to the cardholder's bank. It includes evidence uploaded through specific Square endpoints and any automatically provided evidence. Evidence cannot be removed once submitted.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/disputes/{dispute_id}/submit-evidence".format( # noqa: UP032 + dispute_id=dispute_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def disable_events_search( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DisableEvents'."]: + """Disable events to prevent them from being searchable. + + Use this tool to disable events, preventing them from being searchable, even if re-enabled later. Helpful for managing event visibility.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/events/disable", + method="PUT", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def enable_events_for_search( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'EnableEvents'."]: + """Enable events to make them searchable. + + This tool activates events so that they become searchable. Only events occurring while enabled will be searchable. Use this tool when you need to ensure events are indexed for search.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/events/enable", + method="PUT", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def list_event_types( + context: ToolContext, + api_version: Annotated[ + str | None, + "Specify the API version to list event types. This overrides the default application version.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListEventTypes'."]: + """Retrieve all event types available for webhooks and querying. + + Use this tool to list all the event types you can subscribe to as webhooks or query via the Events API. It helps in understanding which events are trackable and can be used for notifications or further analysis.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/events/types", + method="GET", + params=remove_none_values({"api_version": api_version}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["GIFTCARDS_READ"])) +async def list_gift_cards( + context: ToolContext, + gift_card_type: Annotated[ + str | None, + "Specifies the type of gift cards to retrieve. If not provided, all types are returned.", + ] = None, + gift_card_state: Annotated[ + str | None, "Specifies the state of gift cards to return. Leave empty to get all states." + ] = None, + results_per_page_limit: Annotated[ + int | None, "The number of gift card results per page. Maximum is 200, default is 30." + ] = None, + pagination_cursor: Annotated[ + str | None, + "A string used to retrieve the next set of results for pagination from a previous call.", + ] = None, + customer_id: Annotated[ + str | None, "A unique identifier for a customer to retrieve gift cards linked to them." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListGiftCards'."]: + """Retrieve a list of all gift cards, with optional filters. + + Call this tool to obtain a sorted list of gift cards. You can apply filters to narrow down the results. Useful for managing and reviewing available gift cards.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/gift-cards", + method="GET", + params=remove_none_values({ + "type": gift_card_type, + "state": gift_card_state, + "limit": results_per_page_limit, + "cursor": pagination_cursor, + "customer_id": customer_id, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["GIFTCARDS_READ"])) +async def list_gift_card_activities( + context: ToolContext, + gift_card_id: Annotated[ + str | None, + "Specify a gift card ID to return activities related to that gift card. Leave empty to return all gift card activities for the seller.", # noqa: E501 + ] = None, + activity_type: Annotated[ + str | None, + "Filter gift card activities by specifying a particular activity type. If not provided, returns all activity types.", # noqa: E501 + ] = None, + location_id: Annotated[ + str | None, + "Specify the location ID to filter gift card activities for a particular location. Leave empty to return activities for all locations.", # noqa: E501 + ] = None, + reporting_start_time: Annotated[ + str | None, + "The starting timestamp for the reporting period, in RFC 3339 format. Includes this date and time. Defaults to one year prior from now if not specified.", # noqa: E501 + ] = None, + end_time: Annotated[ + str | None, + "The inclusive end timestamp for the reporting period in RFC 3339 format. Defaults to current time.", # noqa: E501 + ] = None, + result_limit: Annotated[ + int | None, + "Specify the maximum number of results per page. Default is 50, maximum allowed is 100.", + ] = None, + pagination_cursor: Annotated[ + str | None, + "A pagination cursor from a previous call to get the next set of results. If not provided, the first page is returned.", # noqa: E501 + ] = None, + activities_sort_order: Annotated[ + str | None, + "Defines the order of gift card activities based on creation date. Use 'ASC' for oldest to newest, or 'DESC' for newest to oldest (default).", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListGiftCardActivities'."]: + """Retrieve and filter gift card activities for a seller. + + Lists gift card activities from the seller's account. Optionally filter the activities by gift card, region, or within a specific time window.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/gift-cards/activities", + method="GET", + params=remove_none_values({ + "gift_card_id": gift_card_id, + "type": activity_type, + "location_id": location_id, + "begin_time": reporting_start_time, + "end_time": end_time, + "limit": result_limit, + "cursor": pagination_cursor, + "sort_order": activities_sort_order, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["GIFTCARDS_READ"])) +async def get_gift_card_details( + context: ToolContext, + gift_card_id: Annotated[str, "The ID of the gift card to retrieve details for."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveGiftCard'."]: + """Retrieve details of a gift card using its ID. + + Use this tool to access information about a specific gift card by providing its ID. It is useful for checking gift card balance, status, and other related details.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/gift-cards/{id}".format(id=gift_card_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["INVENTORY_READ"])) +async def get_inventory_adjustment( + context: ToolContext, + inventory_adjustment_id: Annotated[ + str, "The unique ID of the inventory adjustment to retrieve details for." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveInventoryAdjustment'."]: + """Retrieve detailed information on an inventory adjustment. + + This tool retrieves the details of a specific InventoryAdjustment using the provided adjustment ID. It should be called when you need to obtain information about changes in inventory quantities.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/inventory/adjustments/{adjustment_id}".format( # noqa: UP032 + adjustment_id=inventory_adjustment_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["INVENTORY_READ"])) +async def retrieve_inventory_physical_count( + context: ToolContext, + inventory_physical_count_id: Annotated[str, "ID of the InventoryPhysicalCount to retrieve."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveInventoryPhysicalCount'."]: + """Retrieve the inventory physical count by its ID. + + Call this tool to obtain information about a specific inventory physical count using the provided `physical_count_id`. It returns the associated InventoryPhysicalCount object.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/inventory/physical-counts/{physical_count_id}".format( # noqa: UP032 + physical_count_id=inventory_physical_count_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["INVENTORY_READ"])) +async def get_inventory_transfer( + context: ToolContext, + inventory_transfer_id: Annotated[ + str, "The unique ID of the InventoryTransfer to retrieve details for." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveInventoryTransfer'."]: + """Retrieve details of an Inventory Transfer using its ID. + + Use this tool to obtain information about a specific Inventory Transfer by providing its transfer ID. This can be useful for tracking inventory movements within a system.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/inventory/transfers/{transfer_id}".format( # noqa: UP032 + transfer_id=inventory_transfer_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["INVENTORY_READ"])) +async def retrieve_inventory_count( + context: ToolContext, + catalog_object_id: Annotated[ + str, + "ID of the CatalogObject to retrieve the inventory count for. Required for specifying which item to query.", # noqa: E501 + ], + location_ids: Annotated[ + str | None, + "Comma-separated list of Location IDs to query. Use empty to query all locations.", + ] = None, + pagination_cursor: Annotated[ + str | None, "A pagination cursor to retrieve the next set of results for an ongoing query." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveInventoryCount'."]: + """Get the current stock count for an item. + + Fetches the current calculated stock level for a specific CatalogObject at specified Locations. Useful for checking inventory availability. Results are paginated and unsorted.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/inventory/{catalog_object_id}".format( # noqa: UP032 + catalog_object_id=catalog_object_id + ), + method="GET", + params=remove_none_values({"location_ids": location_ids, "cursor": pagination_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["INVOICES_READ"])) +async def list_invoices( + context: ToolContext, + location_id: Annotated[str, "The ID of the location for which to list invoices."], + pagination_cursor: Annotated[ + str | None, + "A string value used to fetch the next set of paginated results for invoices. This is returned from a previous call to the list invoices endpoint.", # noqa: E501 + ] = None, + maximum_invoices_to_return: Annotated[ + int | None, + "The maximum number of invoices to return, up to 200. Defaults to 100 if not specified.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListInvoices'."]: + """Retrieve a list of invoices for a specified location. + + Use this tool to get a list of invoices from a specific location. The response is paginated, and if the list is truncated, a cursor is provided to fetch the next set of invoices.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/invoices", + method="GET", + params=remove_none_values({ + "location_id": location_id, + "cursor": pagination_cursor, + "limit": maximum_invoices_to_return, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_WRITE", "INVOICES_WRITE"])) +async def delete_draft_invoice( + context: ToolContext, + invoice_id_to_delete: Annotated[str, "The ID of the draft invoice to be deleted."], + invoice_version_to_delete: Annotated[ + int | None, + "The version number of the draft invoice to delete. Retrieve this using GetInvoice or ListInvoices if unknown.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteInvoice'."]: + """Deletes a specified draft invoice. + + Use this tool to delete a draft invoice. Once deleted, the associated order status changes to CANCELED. This tool cannot delete published invoices.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/invoices/{invoice_id}".format( # noqa: UP032 + invoice_id=invoice_id_to_delete + ), + method="DELETE", + params=remove_none_values({"version": invoice_version_to_delete}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["INVOICES_READ"])) +async def retrieve_invoice_by_id( + context: ToolContext, + invoice_id: Annotated[str, "The unique ID of the invoice to retrieve information for."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetInvoice'."]: + """Retrieve details of an invoice using its ID. + + Use this tool to obtain detailed information about a specific invoice by providing its unique ID. It is useful for accessing invoice data such as amounts, status, and recipient information.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/invoices/{invoice_id}".format(invoice_id=invoice_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["INVOICES_WRITE"])) +async def remove_invoice_attachment( + context: ToolContext, + invoice_id: Annotated[ + str, + "The unique identifier of the invoice to remove the attachment from. Applicable for invoices in specific states (DRAFT, SCHEDULED, UNPAID, PARTIALLY_PAID).", # noqa: E501 + ], + attachment_id: Annotated[ + str, + "The unique identifier of the attachment to delete from the invoice. It should be a string corresponding to the attachment's ID.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteInvoiceAttachment'."]: + """Remove an attachment from an invoice and delete the file. + + Use this tool to permanently delete an attachment from an invoice. It is applicable only for invoices in the DRAFT, SCHEDULED, UNPAID, or PARTIALLY_PAID state.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/invoices/{invoice_id}/attachments/{attachment_id}".format( # noqa: UP032 + invoice_id=invoice_id, attachment_id=attachment_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["TIMECARDS_SETTINGS_READ"])) +async def list_business_break_types( + context: ToolContext, + filter_by_location_id: Annotated[ + str | None, "Filter results to only include BreakTypes associated with a specific location." + ] = None, + max_results_per_page: Annotated[ + int | None, + "The maximum number of BreakType results to return per page, between 1 and 200. Default is 200.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, "A pointer to the next page of BreakType results for retrieval." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListBreakTypes'."]: + """Retrieve a list of BreakType instances for a business. + + This tool provides a paginated list of BreakType instances associated with a business. Use it to fetch information about different break types configured in a business's system.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/labor/break-types", + method="GET", + params=remove_none_values({ + "location_id": filter_by_location_id, + "limit": max_results_per_page, + "cursor": pagination_cursor, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["TIMECARDS_SETTINGS_WRITE"])) +async def delete_break_type( + context: ToolContext, + break_type_uuid: Annotated[ + str, "The UUID of the BreakType to delete. Ensure it is a valid UUID format." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteBreakType'."]: + """Deletes an existing break type. + + Use this tool to delete a specific break type, even if it is referenced by a shift.""" + response = await make_request( + url="https://connect.squareup.com/v2/labor/break-types/{id}".format(id=break_type_uuid), # noqa: UP032 + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["TIMECARDS_SETTINGS_READ"])) +async def retrieve_break_type( + context: ToolContext, + break_type_id: Annotated[ + str, "The unique identifier (UUID) for the BreakType to be retrieved." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetBreakType'."]: + """Retrieve details of a specific break type by ID. + + Use this tool to obtain information about a specific break type using its unique identifier.""" + response = await make_request( + url="https://connect.squareup.com/v2/labor/break-types/{id}".format(id=break_type_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["TIMECARDS_READ"])) +async def get_scheduled_shift( + context: ToolContext, + scheduled_shift_id: Annotated[ + str, "The unique ID of the scheduled shift to retrieve details for." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveScheduledShift'."]: + """Retrieve details of a scheduled shift by ID. + + The tool retrieves information about a scheduled shift using its unique ID. Call this tool when you need detailed information about a specific shift.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/labor/scheduled-shifts/{id}".format( # noqa: UP032 + id=scheduled_shift_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["EMPLOYEES_READ"])) +async def list_team_member_wages( + context: ToolContext, + filter_by_team_member_id: Annotated[ + str | None, + "Filter wages by specifying the team member's ID. Only wages for this team member will be returned.", # noqa: E501 + ] = None, + results_per_page: Annotated[ + int | None, + "Specifies the maximum number of team member wages to return per page, ranging from 1 to 200. Default is 200.", # noqa: E501 + ] = None, + next_page_cursor: Annotated[ + str | None, "A token used to fetch the next page of team member wage results." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListTeamMemberWages'."]: + """Retrieve paginated team member wages for a business. + + Use this tool to obtain a paginated list of wages for team members within a business. Ideal for managing payroll and financial records.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/labor/team-member-wages", + method="GET", + params=remove_none_values({ + "team_member_id": filter_by_team_member_id, + "limit": results_per_page, + "cursor": next_page_cursor, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["EMPLOYEES_READ"])) +async def get_team_member_wage( + context: ToolContext, + team_member_wage_id: Annotated[ + str, "The unique UUID for retrieving the specified team member's wage." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetTeamMemberWage'."]: + """Retrieve wage details for a specified team member. + + Use this tool to obtain wage information for a specific team member by providing their unique ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/labor/team-member-wages/{id}".format( # noqa: UP032 + id=team_member_wage_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["TIMECARDS_WRITE"])) +async def delete_timecard( + context: ToolContext, + timecard_id: Annotated[str, "The UUID for the timecard to be deleted."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteTimecard'."]: + """Deletes a specified timecard. + + Use this tool to delete a timecard by its ID when managing labor records.""" + response = await make_request( + url="https://connect.squareup.com/v2/labor/timecards/{id}".format(id=timecard_id), # noqa: UP032 + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["TIMECARDS_READ"])) +async def retrieve_timecard( + context: ToolContext, + timecard_uuid: Annotated[str, "The unique identifier (UUID) for the Timecard to be retrieved."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveTimecard'."]: + """Retrieve a specific timecard using its ID. + + Use this tool to fetch detailed information about a single timecard by providing its unique identifier.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/labor/timecards/{id}".format(id=timecard_uuid), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["TIMECARDS_SETTINGS_READ"])) +async def list_workweek_configurations( + context: ToolContext, + max_results_per_page: Annotated[ + int | None, "The maximum number of workweek configurations to return per page." + ] = None, + page_cursor: Annotated[ + str | None, + "A string that acts as a pointer to fetch the next page of workweek configuration results.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListWorkweekConfigs'."]: + """Retrieve workweek configurations for a business. + + This tool returns a list of workweek configuration instances, providing details about the workweek setup for a specified business. It should be used when you need to understand or analyze the workweek parameters configured within a business.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/labor/workweek-configs", + method="GET", + params=remove_none_values({"limit": max_results_per_page, "cursor": page_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def list_seller_locations( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListLocations'."]: + """Retrieve details of all seller locations from Square. + + Call this tool to get information about all the seller's locations, including inactive ones, retrieved in alphabetical order by name. Useful for managing or displaying seller location data.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations", + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def list_location_custom_attribute_definitions( + context: ToolContext, + filter_by_visibility: Annotated[ + str | None, "Filter the results by visibility values: ALL, READ, or READ_WRITE." + ] = None, + maximum_results_per_page: Annotated[ + int | None, + "Maximum number of results to return per page. Minimum is 1, maximum is 100, default is 20. Advisory only, may vary.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "The cursor for retrieving the next page of results from a previous call. Use this for pagination handling.", # noqa: E501 + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'ListLocationCustomAttributeDefinitions'." +]: + """Retrieve location custom attribute definitions for a Square account. + + This tool retrieves all location-related custom attribute definitions for a Square seller account. It includes those visible to the requesting application, even if created by other applications. Use this to access custom attribute definitions with various visibility settings.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations/custom-attribute-definitions", + method="GET", + params=remove_none_values({ + "visibility_filter": filter_by_visibility, + "limit": maximum_results_per_page, + "cursor": pagination_cursor, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_WRITE"])) +async def delete_location_custom_attribute( + context: ToolContext, + custom_attribute_key: Annotated[ + str, + "The unique key identifying the custom attribute definition to be deleted from the seller account.", # noqa: E501 + ], +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'DeleteLocationCustomAttributeDefinition'." +]: + """Delete a location-related custom attribute definition. + + Use this tool to delete a specific location-related custom attribute definition from a Square seller account. Only the definition owner can perform this action. Deleting also removes the attribute from all locations.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def retrieve_location_custom_attribute_definition( + context: ToolContext, + custom_attribute_definition_key: Annotated[ + str, + "The key of the custom attribute definition to retrieve, requiring a qualified key if not the owner.", # noqa: E501 + ], + custom_attribute_definition_version: Annotated[ + int | None, + "The version of the custom attribute definition for consistent reads. Must be equal to or less than the latest version to avoid errors.", # noqa: E501 + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'RetrieveLocationCustomAttributeDefinition'." +]: + """Retrieve location-related custom attribute definitions. + + Retrieves a custom attribute definition for a location from a Square seller account. Applicable when needing details on custom attributes for specific locations. Accessible only if visibility is set accordingly.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_definition_key + ), + method="GET", + params=remove_none_values({"version": custom_attribute_definition_version}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def retrieve_location_details( + context: ToolContext, + location_id: Annotated[ + str, 'The ID of the location to retrieve. Use "main" for the main location.' + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLocation'."]: + """Retrieve detailed information about a specific location. + + Call this tool to obtain information about a particular location by providing the location ID. Use \"main\" as the ID to get details about the main location.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations/{location_id}".format( # noqa: UP032 + location_id=location_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def list_location_custom_attributes( + context: ToolContext, + location_id: Annotated[ + str, "The ID of the target location for which to fetch custom attributes." + ], + visibility_filter: Annotated[ + str | None, + "Filters custom attribute results based on their visibility values (ALL, READ, READ_WRITE).", # noqa: E501 + ] = None, + max_results_per_page: Annotated[ + int | None, + "The maximum number of results to fetch per page. Minimum is 1, maximum is 100, default is 20.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "String value of the cursor from previous response, used for paginating results.", + ] = None, + include_custom_attribute_definitions: Annotated[ + bool | None, + "Set to true to include custom attribute definitions with each custom attribute. Default is false.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListLocationCustomAttributes'."]: + """Fetch custom attributes for a specific location. + + Use this tool to list custom attributes associated with a specific location. It can also retrieve custom attribute definitions if needed. It includes attributes visible to the requesting app, even if owned by others.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations/{location_id}/custom-attributes".format( # noqa: UP032 + location_id=location_id + ), + method="GET", + params=remove_none_values({ + "visibility_filter": visibility_filter, + "limit": max_results_per_page, + "cursor": pagination_cursor, + "with_definitions": include_custom_attribute_definitions, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_WRITE"])) +async def remove_location_custom_attribute( + context: ToolContext, + location_id: Annotated[ + str, "The ID of the target location for which the custom attribute will be deleted." + ], + custom_attribute_key: Annotated[ + str, + "The key for the custom attribute to delete. Use the qualified key if not the definition owner.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteLocationCustomAttribute'."]: + """Deletes a custom attribute from a specified location. + + Use this tool to delete a custom attribute associated with a specified location. Ensure that the attribute's visibility is set to `VISIBILITY_READ_WRITE_VALUES` if it is owned by another application.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations/{location_id}/custom-attributes/{key}".format( # noqa: UP032 + location_id=location_id, key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def get_location_custom_attribute( + context: ToolContext, + location_id: Annotated[ + str, + "The ID of the location for which the custom attribute is being retrieved. This is required to identify the specific location in the Square account.", # noqa: E501 + ], + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute to retrieve. Must match a custom attribute definition key in the Square seller account. Use the qualified key if not the definition owner.", # noqa: E501 + ], + custom_attribute_version: Annotated[ + int | None, + "Specify the version of the custom attribute for consistent reads. If a higher version exists, it is returned. If higher than the current version, an error occurs.", # noqa: E501 + ] = None, + include_definition: Annotated[ + bool | None, + "Set to true to include the custom attribute's definition, providing name, description, and data type.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLocationCustomAttribute'."]: + """Retrieve a custom attribute for a specified location. + + This tool fetches a custom attribute associated with a specific location. Optional retrieval of the custom attribute's definition is available. Visibility settings must permit access if owned by another application.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/locations/{location_id}/custom-attributes/{key}".format( # noqa: UP032 + location_id=location_id, key=custom_attribute_key + ), + method="GET", + params=remove_none_values({ + "with_definition": include_definition, + "version": custom_attribute_version, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["LOYALTY_READ"])) +async def retrieve_loyalty_account( + context: ToolContext, + loyalty_account_id: Annotated[str, "The unique identifier of the loyalty account to retrieve."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLoyaltyAccount'."]: + """Retrieve information about a loyalty account. + + Use this tool to get detailed information about a specific loyalty account using the account ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/loyalty/accounts/{account_id}".format( # noqa: UP032 + account_id=loyalty_account_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["LOYALTY_READ"])) +async def retrieve_loyalty_program( + context: ToolContext, + loyalty_program_identifier: Annotated[ + str, "The ID of the loyalty program or the keyword 'main' to retrieve the program details." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLoyaltyProgram'."]: + """Retrieve details of a seller's loyalty program. + + Use this tool to obtain information about a seller's loyalty program by specifying the program ID or using the keyword 'main'. It provides details on how buyers can earn and redeem points.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/loyalty/programs/{program_id}".format( # noqa: UP032 + program_id=loyalty_program_identifier + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["LOYALTY_READ"])) +async def list_loyalty_promotions( + context: ToolContext, + loyalty_program_id: Annotated[ + str, + "The ID of the base loyalty program. Use the 'RetrieveLoyaltyProgram' API with 'main' to get this ID.", # noqa: E501 + ], + filter_by_status: Annotated[ + str | None, + "Filter loyalty promotions by status. Options: ACTIVE, ENDED, CANCELED, SCHEDULED.", + ] = None, + pagination_cursor: Annotated[ + str | None, + "The cursor for retrieving the next page of loyalty promotions. Obtain this from the previous response to continue pagination.", # noqa: E501 + ] = None, + max_results_per_page: Annotated[ + int | None, + "Specifies the maximum number of loyalty promotions to return per page. Must be between 1 and 30. Default is 30.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListLoyaltyPromotions'."]: + """Fetches loyalty promotions for a specific program. + + Use this tool to retrieve a list of loyalty promotions linked to a specific loyalty program, sorted by their creation date, from newest to oldest.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/loyalty/programs/{program_id}/promotions".format( # noqa: UP032 + program_id=loyalty_program_id + ), + method="GET", + params=remove_none_values({ + "status": filter_by_status, + "cursor": pagination_cursor, + "limit": max_results_per_page, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["LOYALTY_READ"])) +async def retrieve_loyalty_promotion( + context: ToolContext, + loyalty_promotion_id: Annotated[ + str, "The unique identifier for the loyalty promotion to retrieve." + ], + loyalty_program_id: Annotated[ + str, + "The ID of the base loyalty program. Retrieve it by calling RetrieveLoyaltyProgram with the 'main' keyword.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLoyaltyPromotion'."]: + """Retrieve details of a specific loyalty promotion. + + Use this tool to get information about a specific loyalty promotion identified by program and promotion IDs. Call this tool when you need to access or display details of a particular loyalty promotion.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/loyalty/programs/{program_id}/promotions/{promotion_id}".format( # noqa: UP032 + promotion_id=loyalty_promotion_id, program_id=loyalty_program_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["LOYALTY_WRITE"])) +async def cancel_loyalty_promotion( + context: ToolContext, + loyalty_promotion_id: Annotated[ + str, + "The unique identifier of the loyalty promotion to be canceled. Applicable for promotions with an 'ACTIVE' or 'SCHEDULED' status.", # noqa: E501 + ], + loyalty_program_id: Annotated[str, "The unique ID of the base loyalty program to be canceled."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'CancelLoyaltyPromotion'."]: + """Cancel an active or scheduled loyalty promotion early. + + Use this tool to set a loyalty promotion to the 'CANCELED' state. It is useful for canceling active promotions earlier than planned or canceling scheduled promotions before they begin. This is also applicable if you need to cancel one prior to creating a new promotion.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/loyalty/programs/{program_id}/promotions/{promotion_id}/cancel".format( # noqa: UP032 + promotion_id=loyalty_promotion_id, program_id=loyalty_program_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["LOYALTY_WRITE"])) +async def delete_loyalty_reward( + context: ToolContext, + reward_id: Annotated[ + str, + "The ID of the loyalty reward to delete. This is required to identify which reward to remove and restore points for.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteLoyaltyReward'."]: + """Delete a loyalty reward and restore loyalty points. + + Use this tool to delete a loyalty reward, which restores loyalty points to the account. It also updates the associated order by removing the reward and related discounts if an order ID was specified. The reward cannot be deleted if it has been redeemed.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/loyalty/rewards/{reward_id}".format( # noqa: UP032 + reward_id=reward_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["LOYALTY_READ"])) +async def retrieve_loyalty_reward( + context: ToolContext, + loyalty_reward_id: Annotated[str, "The unique ID of the loyalty reward to retrieve."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLoyaltyReward'."]: + """Retrieve details of a loyalty reward. + + This tool is used to fetch information about a specific loyalty reward by providing the reward ID. It should be called when details about a particular reward are needed.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/loyalty/rewards/{reward_id}".format( # noqa: UP032 + reward_id=loyalty_reward_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def get_merchant_details( + context: ToolContext, + previous_response_cursor: Annotated[ + int | None, + "The cursor generated by the previous response. Use this to fetch the next set of merchant details if needed.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListMerchants'."]: + """Retrieve merchant details using an access token. + + Provides information about the merchant linked to the specified access token. Typically returns a single merchant object. Useful for obtaining merchant details for personal or OAuth token-based access.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants", + method="GET", + params=remove_none_values({"cursor": previous_response_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def list_merchant_custom_attribute_definitions( + context: ToolContext, + filter_by_visibility: Annotated[ + str | None, + "Specify the visibility to filter custom attribute definitions. Options: 'ALL', 'READ', 'READ_WRITE'.", # noqa: E501 + ] = None, + max_results_per_page: Annotated[ + int | None, + "Specifies the maximum number of results to return per page. Valid values are between 1 and 100. Defaults to 20.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, "Cursor to retrieve the next page of results from a previous API call response." + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'ListMerchantCustomAttributeDefinitions'." +]: + """Retrieve custom attribute definitions for a Square seller account. + + Lists all visible merchant-related custom attribute definitions for a Square seller account, including those created by other applications.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants/custom-attribute-definitions", + method="GET", + params=remove_none_values({ + "visibility_filter": filter_by_visibility, + "limit": max_results_per_page, + "cursor": pagination_cursor, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_WRITE"])) +async def delete_merchant_custom_attribute( + context: ToolContext, + attribute_key_to_delete: Annotated[ + str, "The key of the custom attribute definition to delete from the merchant account." + ], +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'DeleteMerchantCustomAttributeDefinition'." +]: + """Delete a custom attribute definition from a merchant account. + + Use this tool to delete a merchant-related custom attribute definition from a Square seller account. This action also removes the corresponding custom attribute from the merchant. Note that only the definition owner can perform this deletion.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=attribute_key_to_delete + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def retrieve_merchant_custom_attribute( + context: ToolContext, + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute definition to retrieve. Use the qualified key if not the definition owner.", # noqa: E501 + ], + custom_attribute_version: Annotated[ + int | None, + "The version of the custom attribute definition required for consistent reads. It returns the specified or a higher version if available, or an error if higher than the current version.", # noqa: E501 + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'RetrieveMerchantCustomAttributeDefinition'." +]: + """Retrieve a merchant's custom attribute definition. + + This tool retrieves custom attribute definitions related to a merchant from a Square seller account. It is useful when you need to access specific attribute definitions created within an account. The attribute definition must have a visibility setting of 'VISIBILITY_READ_ONLY' or 'VISIBILITY_READ_WRITE_VALUES' if created by another application.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_key + ), + method="GET", + params=remove_none_values({"version": custom_attribute_version}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def retrieve_merchant_info( + context: ToolContext, + merchant_id: Annotated[ + str, + "The unique ID of the merchant to retrieve. Use 'me' to access the current accessible merchant.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveMerchant'."]: + """Retrieve details of a specific merchant using merchant ID. + + Use this tool to obtain the `Merchant` object details by providing the `merchant_id`. It should be called when users need specific information about a merchant via their unique ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants/{merchant_id}".format( # noqa: UP032 + merchant_id=merchant_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def list_merchant_custom_attributes( + context: ToolContext, + merchant_id: Annotated[ + str, + "The ID of the target merchant. Use this to specify which merchant's custom attributes you want to retrieve.", # noqa: E501 + ], + filter_by_visibility: Annotated[ + str | None, + "Specify how to filter custom attribute definitions by visibility. Options: 'ALL', 'READ', 'READ_WRITE'.", # noqa: E501 + ] = None, + max_results_per_page: Annotated[ + int | None, + "Maximum number of results per single paged response. Value must be between 1 and 100, with a default of 20.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, "The cursor from the previous response to retrieve the next page of results." + ] = None, + include_custom_attribute_definitions: Annotated[ + bool | None, + "Set to `true` to include custom attribute definitions, including their name, description, and data type. Default is `false`.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListMerchantCustomAttributes'."]: + """Retrieve custom attributes for a specified merchant. + + Use this tool to get custom attributes associated with a merchant. You can optionally include definitions of these attributes. The tool returns all attributes visible to the requesting application, including those with read-only or read-write visibility.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants/{merchant_id}/custom-attributes".format( # noqa: UP032 + merchant_id=merchant_id + ), + method="GET", + params=remove_none_values({ + "visibility_filter": filter_by_visibility, + "limit": max_results_per_page, + "cursor": pagination_cursor, + "with_definitions": include_custom_attribute_definitions, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_WRITE"])) +async def remove_merchant_custom_attribute( + context: ToolContext, + merchant_identifier: Annotated[ + str, "The unique identifier of the target merchant whose custom attribute will be deleted." + ], + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute to delete. It must match a custom attribute definition in the Square seller account. Use a qualified key if not the definition owner.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteMerchantCustomAttribute'."]: + """Deletes a custom attribute from a merchant. + + Use this tool to delete a custom attribute associated with a merchant. The attribute can only be deleted if its visibility is set to 'VISIBILITY_READ_WRITE_VALUES' if owned by another application.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants/{merchant_id}/custom-attributes/{key}".format( # noqa: UP032 + merchant_id=merchant_identifier, key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def get_merchant_custom_attribute( + context: ToolContext, + merchant_id: Annotated[ + str, + "The unique identifier for the target merchant whose custom attribute is to be retrieved.", + ], + custom_attribute_key: Annotated[ + str, + "The key of the custom attribute to retrieve. Must match the `key` of a custom attribute definition in the Square seller account.", # noqa: E501 + ], + custom_attribute_version: Annotated[ + int | None, + "Specifies the version of the custom attribute for consistent reads. If higher than current, returns an error.", # noqa: E501 + ] = None, + include_definition: Annotated[ + bool | None, + "Set to true to include the custom attribute definition, providing additional details such as name, description, and data type.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveMerchantCustomAttribute'."]: + """Retrieve a custom attribute for a specific merchant. + + This tool retrieves a custom attribute associated with a merchant. Use it to access merchant-specific data, with the option to include the custom attribute definition. Visibility settings dictate access permissions.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/merchants/{merchant_id}/custom-attributes/{key}".format( # noqa: UP032 + merchant_id=merchant_id, key=custom_attribute_key + ), + method="GET", + params=remove_none_values({ + "with_definition": include_definition, + "version": custom_attribute_version, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ"])) +async def retrieve_checkout_location_settings( + context: ToolContext, + location_id: Annotated[str, "The unique identifier for the location to retrieve settings for."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveLocationSettings'."]: + """Retrieve location-level settings for a Square checkout page. + + Fetches the settings for a specified location's Square-hosted checkout page. Useful for accessing configuration details or customizing checkout experiences based on location.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/online-checkout/location-settings/{location_id}".format( # noqa: UP032 + location_id=location_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool( + requires_auth=OAuth2( + id="arcade-squareup", scopes=["MERCHANT_PROFILE_READ", "PAYMENT_METHODS_READ"] + ) +) +async def get_square_merchant_settings( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveMerchantSettings'."]: + """Retrieve merchant settings for Square checkout pages. + + Use this tool to get the merchant-level settings configured for a Square-hosted checkout page. Useful for accessing checkout configurations and preferences.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/online-checkout/merchant-settings", + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_READ"])) +async def list_payment_links( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "A string cursor for paginating results. Use it to fetch the next set of results from a previous query. Leave blank to get the first page.", # noqa: E501 + ] = None, + results_per_page_limit: Annotated[ + int | None, + "Sets the maximum number of payment links to return per page. Defaults to 100, ignored if negative or exceeds 1000.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListPaymentLinks'."]: + """Retrieve all available payment links from Squareup. + + Use this tool to list all payment links generated in your Squareup account. It helps in managing and reviewing payment links efficiently.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/online-checkout/payment-links", + method="GET", + params=remove_none_values({"cursor": pagination_cursor, "limit": results_per_page_limit}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_WRITE", "ORDERS_READ"])) +async def delete_payment_link( + context: ToolContext, + payment_link_id: Annotated[ + str, + "The ID of the payment link you want to delete. Provide the specific link ID to proceed with deletion.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeletePaymentLink'."]: + """Deletes a specified payment link. + + Use this tool to delete a payment link by providing the link's ID. Call it when you need to remove a payment link from your system.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/online-checkout/payment-links/{id}".format( # noqa: UP032 + id=payment_link_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_READ"])) +async def retrieve_payment_link( + context: ToolContext, + payment_link_id: Annotated[str, "The unique ID of the payment link to retrieve details for."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrievePaymentLink'."]: + """Retrieve details of a specified payment link. + + Use this tool to get details about a specific payment link by providing its unique ID. Ideal for retrieving information about payment transactions handled via Squareup.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/online-checkout/payment-links/{id}".format( # noqa: UP032 + id=payment_link_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_READ"])) +async def list_order_custom_attribute_definitions( + context: ToolContext, + custom_attribute_visibility_filter: Annotated[ + str | None, "Specifies which custom attributes to return: all, read-only, or read-write." + ] = None, + pagination_cursor: Annotated[ + str | None, + "The cursor from the previous response to get the next page of results. See [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + ] = None, + maximum_results_per_page: Annotated[ + int | None, + "The maximum number of results to return in a single paged response. Minimum is 1, maximum is 100. Default is 20.", # noqa: E501 + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'ListOrderCustomAttributeDefinitions'." +]: + """Retrieve order-related custom attribute definitions for a Square seller. + + Use this tool to list all order-related custom attribute definitions for a Square seller account. It includes attributes visible to the requesting application, even those created by other applications, with various visibility settings.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/orders/custom-attribute-definitions", + method="GET", + params=remove_none_values({ + "visibility_filter": custom_attribute_visibility_filter, + "cursor": pagination_cursor, + "limit": maximum_results_per_page, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_WRITE"])) +async def delete_order_custom_attribute_definition( + context: ToolContext, + custom_attribute_key: Annotated[ + str, + "The key identifying the custom attribute definition to be deleted from the seller's account.", # noqa: E501 + ], +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'DeleteOrderCustomAttributeDefinition'." +]: + """Delete an order-related custom attribute definition. + + Deletes a custom attribute definition related to an order from a Square seller account. Only the owner of the definition can perform this action.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/orders/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_READ"])) +async def retrieve_order_custom_attribute_definition( + context: ToolContext, + custom_attribute_key: Annotated[ + str, "The key of the custom attribute definition to retrieve for an order." + ], + current_version_of_custom_attribute: Annotated[ + int | None, + "Specify the current version of the custom attribute for optimistic concurrency control. Optional.", # noqa: E501 + ] = None, +) -> Annotated[ + dict[str, Any], "Response from the API endpoint 'RetrieveOrderCustomAttributeDefinition'." +]: + """Retrieve custom attribute definition for a Square order. + + Use this tool to fetch a specific custom attribute definition related to an order from a Square seller account. The custom attribute must be set to specific visibility settings to be accessible.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/orders/custom-attribute-definitions/{key}".format( # noqa: UP032 + key=custom_attribute_key + ), + method="GET", + params=remove_none_values({"version": current_version_of_custom_attribute}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_READ"])) +async def retrieve_order_by_id( + context: ToolContext, + order_id: Annotated[str, "The unique identifier for the order to retrieve details for."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveOrder'."]: + """Retrieve order details by Order ID. + + Use this tool to retrieve detailed information about a specific order using its Order ID. It is useful for checking order status, contents, and other order-related details.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/orders/{order_id}".format(order_id=order_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_READ"])) +async def list_order_custom_attributes( + context: ToolContext, + target_order_id: Annotated[ + str, "The ID of the specific order for which to retrieve custom attributes." + ], + attribute_visibility_filter: Annotated[ + str | None, + "Select which custom attributes to return: 'ALL' for all, 'READ' for read-only, 'READ_WRITE' for read-write attributes.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "The pagination cursor from the previous response to retrieve the next page of results.", + ] = None, + max_results_per_page: Annotated[ + int | None, + "The maximum number of results to return in a single paged response. Accepts an integer between 1 and 100. Default is 20.", # noqa: E501 + ] = None, + include_custom_attribute_definitions: Annotated[ + bool | None, + "Set to true to include custom attribute definitions with the order attributes. Default is false.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListOrderCustomAttributes'."]: + """Retrieve custom attributes linked to a specific order. + + This tool retrieves custom attribute details for a specified order, including all attributes visible to the requesting application across different visibility settings. It supports fetching custom attribute definitions as well.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/orders/{order_id}/custom-attributes".format( # noqa: UP032 + order_id=target_order_id + ), + method="GET", + params=remove_none_values({ + "visibility_filter": attribute_visibility_filter, + "cursor": pagination_cursor, + "limit": max_results_per_page, + "with_definitions": include_custom_attribute_definitions, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_WRITE"])) +async def delete_order_custom_attribute( + context: ToolContext, + order_id: Annotated[ + str, + "The unique identifier for the target order from which the custom attribute will be deleted. This ID is crucial for locating the correct order.", # noqa: E501 + ], + custom_attribute_key: Annotated[ + str, + "Specifies the key of the custom attribute to be deleted. It must match an existing custom attribute definition's key.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteOrderCustomAttribute'."]: + """Delete a custom attribute from an order. + + Use this tool to delete a specific custom attribute associated with an order. This is necessary when a custom attribute has the 'VISIBILITY_READ_WRITE_VALUES' setting or is defined by the seller.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/orders/{order_id}/custom-attributes/{custom_attribute_key}".format( # noqa: UP032 + order_id=order_id, custom_attribute_key=custom_attribute_key + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ORDERS_READ"])) +async def retrieve_order_custom_attribute( + context: ToolContext, + order_id: Annotated[str, "The ID of the target order to retrieve the custom attribute for."], + custom_attribute_key: Annotated[ + str, + "The key for retrieving the custom attribute associated with the order. Must match an existing definition key.", # noqa: E501 + ], + current_version: Annotated[ + int | None, + "Specify the current version of the custom attribute for optimistic concurrency control. This is an optional integer value.", # noqa: E501 + ] = None, + include_custom_attribute_definition: Annotated[ + bool | None, + "Set to true to include the custom attribute definition details in the response, such as name, description, and data type.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveOrderCustomAttribute'."]: + """Retrieve a custom attribute associated with an order. + + This tool retrieves a custom attribute linked to a specified order. It can also return the custom attribute definition if requested. Use this when you need information about custom fields attached to an order, especially those with specific visibility settings.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/orders/{order_id}/custom-attributes/{custom_attribute_key}".format( # noqa: UP032 + order_id=order_id, custom_attribute_key=custom_attribute_key + ), + method="GET", + params=remove_none_values({ + "version": current_version, + "with_definition": include_custom_attribute_definition, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_READ"])) +async def fetch_payment_list( + context: ToolContext, + start_time_for_payment_retrieval: Annotated[ + str | None, + "The start time for retrieving payments, in RFC 3339 format, using the `created_at` field. Default is current time minus one year.", # noqa: E501 + ] = None, + payment_retrieval_end_time: Annotated[ + str | None, + "The end of the time range to retrieve payments, in RFC 3339 format. Defaults to the current time.", # noqa: E501 + ] = None, + order_results_by: Annotated[ + str | None, + "Specify the order of payment results: 'ASC' for oldest to newest, 'DESC' for newest to oldest (default).", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "A cursor from a previous call for fetching the next set of payment results. Use it for pagination.", # noqa: E501 + ] = None, + limit_results_by_location: Annotated[ + str | None, + "Specify the location ID to limit payment results to that location. Defaults to the main seller location if not provided.", # noqa: E501 + ] = None, + exact_payment_amount: Annotated[ + int | None, + "The exact amount of the payment in the total_money field. Provide as an integer value.", + ] = None, + payment_card_last_four_digits: Annotated[ + str | None, "The last four digits of a payment card to filter specific payments." + ] = None, + payment_card_brand: Annotated[ + str | None, "The brand of the payment card to filter payments by (e.g., VISA, MasterCard)." + ] = None, + max_results_per_page: Annotated[ + int | None, + "Specify the maximum number of payment records to return per page, up to 100. Values over 100 are ignored.", # noqa: E501 + ] = None, + offline_payment_start_time: Annotated[ + str | None, + "Indicate the start of the time range for retrieving offline payments in RFC 3339 format. Defaults to the current time.", # noqa: E501 + ] = None, + offline_payment_end_time: Annotated[ + str | None, + "End time in RFC 3339 format to retrieve offline payments, based on `client_created_at`. Defaults to current time.", # noqa: E501 + ] = None, + updated_at_start_time: Annotated[ + str | None, + "Start time in RFC 3339 format to retrieve payments using the `updated_at` field.", + ] = None, + end_time_for_update_retrieval: Annotated[ + str | None, "The end time in RFC 3339 format to filter payments by the `updated_at` field." + ] = None, + sort_results_by_field: Annotated[ + str | None, + "Specify the field to sort the payment results by. Options are 'CREATED_AT', 'OFFLINE_CREATED_AT', or 'UPDATED_AT'. Default is 'CREATED_AT'.", # noqa: E501 + ] = None, + include_offline_payments: Annotated[ + bool | None, "Set to true to include payments taken offline. False excludes them." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListPayments'."]: + """Retrieve a list of payments for an account. + + This tool calls the Squareup API to fetch a list of payments associated with the account making the request. It should be called when you need to access recent payment records. Note that results are eventually consistent, and there may be slight delays in updates.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/payments", + method="GET", + params=remove_none_values({ + "begin_time": start_time_for_payment_retrieval, + "end_time": payment_retrieval_end_time, + "sort_order": order_results_by, + "cursor": pagination_cursor, + "location_id": limit_results_by_location, + "total": exact_payment_amount, + "last_4": payment_card_last_four_digits, + "card_brand": payment_card_brand, + "limit": max_results_per_page, + "is_offline_payment": include_offline_payments, + "offline_begin_time": offline_payment_start_time, + "offline_end_time": offline_payment_end_time, + "updated_at_begin_time": updated_at_start_time, + "updated_at_end_time": end_time_for_update_retrieval, + "sort_field": sort_results_by_field, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_READ"])) +async def get_payment_details( + context: ToolContext, + payment_id: Annotated[ + str, "A unique ID for the desired payment to retrieve specific payment details." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetPayment'."]: + """Retrieve specific payment details by payment ID. + + Use this tool to obtain detailed information about a specific payment using its payment ID.""" + response = await make_request( + url="https://connect.squareup.com/v2/payments/{payment_id}".format(payment_id=payment_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_WRITE"])) +async def cancel_approved_payment( + context: ToolContext, + payment_identifier: Annotated[ + str, + "The unique ID of the payment to cancel. This ID must correspond to a payment with an APPROVED status.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'CancelPayment'."]: + """Cancel an approved payment transaction. + + Use this tool to void a payment that has an APPROVED status. This can be useful when a transaction needs to be reversed before completion.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/payments/{payment_id}/cancel".format( # noqa: UP032 + payment_id=payment_identifier + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def get_payout_list( + context: ToolContext, + location_id: Annotated[ + str | None, + "ID of the location to list payouts. Defaults to the main location if not specified.", + ] = None, + payout_status_filter: Annotated[ + str | None, "Filter payouts by status: 'SENT', 'FAILED', or 'PAID'." + ] = None, + start_time_for_payouts: Annotated[ + str | None, + "RFC 3339 formatted timestamp for the beginning of payout creation. Defaults to one year ago.", # noqa: E501 + ] = None, + end_time: Annotated[ + str | None, + "The timestamp for the end of the payout creation time, in RFC 3339 format. Defaults to the current time if not provided.", # noqa: E501 + ] = None, + sort_order: Annotated[ + str | None, + "Determines if the list of payouts is sorted in ascending ('ASC') or descending ('DESC') order.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "A pagination cursor from a previous call, used to retrieve the next set of results.", + ] = None, + max_results_per_page: Annotated[ + int | None, + "The maximum number of results to return per page. Must be 100 or fewer; defaults to 100 if a higher value is provided.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListPayouts'."]: + """Retrieve a list of all payouts for the default location. + + This tool retrieves all payouts for the default location, allowing filtration by location ID, status, time range, and sorting order. It requires the `PAYOUTS_READ` OAuth scope.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/payouts", + method="GET", + params=remove_none_values({ + "location_id": location_id, + "status": payout_status_filter, + "begin_time": start_time_for_payouts, + "end_time": end_time, + "sort_order": sort_order, + "cursor": pagination_cursor, + "limit": max_results_per_page, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def get_payout_details( + context: ToolContext, + payout_id: Annotated[str, "The unique identifier of the payout to retrieve details for."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetPayout'."]: + """Retrieve details of a specific payout by payout ID. + + Use this tool to get detailed information about a specific payout by providing the payout ID. Useful for tracking or reviewing specific payout transactions.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/payouts/{payout_id}".format(payout_id=payout_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def list_payout_entries( + context: ToolContext, + payout_id: Annotated[ + str, + "The unique ID of the payout to retrieve entries for. Essential for identifying the payout for which entries are needed.", # noqa: E501 + ], + payout_entries_sort_order: Annotated[ + str | None, + "Specifies the order in which payout entries are listed. Use 'DESC' for descending or 'ASC' for ascending order.", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, + "Provide this cursor to retrieve the next set of results for the original query. A pagination cursor from a previous call.", # noqa: E501 + ] = None, + max_results_per_page: Annotated[ + int | None, + "Sets the maximum number of results to retrieve per page, up to 100. Defaults to 100 if the value exceeds this limit.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListPayoutEntries'."]: + """Retrieve all payout entries for a specific payout. + + Fetches a list of all payout entries associated with a particular payout ID. Ideal for obtaining detailed payout information from Square.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/payouts/{payout_id}/payout-entries".format( # noqa: UP032 + payout_id=payout_id + ), + method="GET", + params=remove_none_values({ + "sort_order": payout_entries_sort_order, + "cursor": pagination_cursor, + "limit": max_results_per_page, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_READ"])) +async def list_payment_refunds( + context: ToolContext, + start_time_for_refund_retrieval: Annotated[ + str | None, + "Start of the time range for retrieving PaymentRefund in RFC 3339 format, based on the created_at field. Defaults to one year ago.", # noqa: E501 + ] = None, + refund_end_time: Annotated[ + str | None, + "Specifies the end date and time for the refund retrieval range in RFC 3339 format, defaulting to the current time if not specified.", # noqa: E501 + ] = None, + results_sort_order: Annotated[ + str | None, + "Set the order for listing results by `PaymentRefund.created_at`. Use 'ASC' for oldest to newest, 'DESC' for newest to oldest (default).", # noqa: E501 + ] = None, + pagination_cursor: Annotated[ + str | None, "A pagination cursor from a previous call to retrieve the next set of results." + ] = None, + limit_results_to_location: Annotated[ + str | None, + "Specify the location ID to filter results for that location. Defaults to all seller-associated locations.", # noqa: E501 + ] = None, + refund_status_filter: Annotated[ + str | None, + "Filter refunds by specific status. Uses status values defined in PaymentRefund entity. If omitted, all statuses are included.", # noqa: E501 + ] = None, + payment_source_type: Annotated[ + str | None, + "Specify the source type of payments to filter refunds. Options: CARD, BANK_ACCOUNT, WALLET, CASH, EXTERNAL. If omitted, all source types are included.", # noqa: E501 + ] = None, + max_results_per_page: Annotated[ + int | None, "Specify the maximum number of refund results per page, up to a maximum of 100." + ] = None, + updated_at_start_time: Annotated[ + str | None, + "The start of the time range for retrieving refunds, based on the `updated_at` field, in RFC 3339 format. Defaults to `begin_time` if omitted.", # noqa: E501 + ] = None, + updated_at_end_time: Annotated[ + str | None, + "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339 format. Defaults to the current time.", # noqa: E501 + ] = None, + sort_results_by_field: Annotated[ + str | None, + "Specifies the field to sort refund results by. Options are 'CREATED_AT' or 'UPDATED_AT'.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListPaymentRefunds'."]: + """Retrieve a list of payment refunds for the account. + + Fetches a list of refunds associated with the account making the request. Suitable for monitoring refund transactions, with a maximum of 100 results per page. Results may take several seconds to update due to eventual consistency.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/refunds", + method="GET", + params=remove_none_values({ + "begin_time": start_time_for_refund_retrieval, + "end_time": refund_end_time, + "sort_order": results_sort_order, + "cursor": pagination_cursor, + "location_id": limit_results_to_location, + "status": refund_status_filter, + "source_type": payment_source_type, + "limit": max_results_per_page, + "updated_at_begin_time": updated_at_start_time, + "updated_at_end_time": updated_at_end_time, + "sort_field": sort_results_by_field, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_READ"])) +async def fetch_specific_refund( + context: ToolContext, + specific_refund_id: Annotated[str, "The unique ID for the specific PaymentRefund to retrieve."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetPaymentRefund'."]: + """Retrieve details of a specific refund using its ID. + + Call this tool to fetch information about a particular refund by providing the refund ID. This is useful for checking the status and details of any refund made through the system.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/refunds/{refund_id}".format( # noqa: UP032 + refund_id=specific_refund_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ONLINE_STORE_SITE_READ"])) +async def list_square_online_sites( + context: ToolContext, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListSites'."]: + """Retrieve a list of Square Online sites for a seller. + + Use this tool to obtain a list of Square Online sites associated with a seller, ordered by their creation date. This is part of Square's early access program for online APIs.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/sites", + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ONLINE_STORE_SNIPPETS_WRITE"])) +async def remove_square_online_snippet( + context: ToolContext, + site_id_for_snippet_removal: Annotated[ + str, "The unique ID of the Square Online site containing the snippet to remove." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteSnippet'."]: + """Delete a snippet from a Square Online site. + + Use this tool to remove a snippet from a Square Online site. Call it when you have the site ID from which you want to delete the snippet. Ideal for managing online site content efficiently.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/sites/{site_id}/snippet".format( # noqa: UP032 + site_id=site_id_for_snippet_removal + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["ONLINE_STORE_SNIPPETS_READ"])) +async def retrieve_site_snippet( + context: ToolContext, + site_identifier: Annotated[ + str, "The unique ID of the Square Online site containing your application's snippet." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveSnippet'."]: + """Retrieve snippets from a Square Online site. + + Use this tool to retrieve the snippet added by your application from a specified Square Online site. Ideal for accessing custom code snippets associated with your applications on Square sites.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/sites/{site_id}/snippet".format( # noqa: UP032 + site_id=site_identifier + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["SUBSCRIPTIONS_READ"])) +async def retrieve_subscription( + context: ToolContext, + subscription_id: Annotated[str, "The ID of the subscription to retrieve."], + include_related_info: Annotated[ + str | None, + "Specify related info to include in the response, such as 'actions' for scheduled actions.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveSubscription'."]: + """Retrieve details of a specific subscription. + + This tool retrieves information about a specific subscription using its ID. It is called when detailed subscription data is needed, such as for review or management purposes.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/subscriptions/{subscription_id}".format( # noqa: UP032 + subscription_id=subscription_id + ), + method="GET", + params=remove_none_values({"include": include_related_info}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["SUBSCRIPTIONS_WRITE"])) +async def delete_subscription_action( + context: ToolContext, + subscription_id: Annotated[ + str, + "The ID of the subscription for which the action is to be deleted. This ID is required to identify the specific subscription being targeted.", # noqa: E501 + ], + action_id: Annotated[str, "The ID of the specific action to be deleted from a subscription."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteSubscriptionAction'."]: + """Delete a scheduled action from a subscription. + + This tool deletes a specific scheduled action associated with a subscription identified by its subscription and action IDs. Use it to cancel or remove actions that are no longer needed from a subscription plan.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/subscriptions/{subscription_id}/actions/{action_id}".format( # noqa: UP032 + subscription_id=subscription_id, action_id=action_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["SUBSCRIPTIONS_WRITE"])) +async def cancel_subscription( + context: ToolContext, + subscription_identifier: Annotated[ + str, + "The unique identifier of the subscription to be canceled. Required to schedule the cancellation.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'CancelSubscription'."]: + """Schedule cancellation of an active subscription. + + Use this tool to schedule a cancellation for an active subscription. The subscription will remain active until the end of the current billing period, after which it will be marked as canceled.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/subscriptions/{subscription_id}/cancel".format( # noqa: UP032 + subscription_id=subscription_identifier + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["SUBSCRIPTIONS_READ"])) +async def list_subscription_events( + context: ToolContext, + subscription_id: Annotated[ + str, + "The unique ID of the subscription to retrieve events for. Use this to specify which subscription's events to list.", # noqa: E501 + ], + pagination_cursor: Annotated[ + str | None, + "Specify the cursor to fetch the next set of subscription events if results exceed the limit. Leave unset for the last page.", # noqa: E501 + ] = None, + max_events_per_page: Annotated[ + int | None, "The maximum number of subscription events to return in a single response page." + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListSubscriptionEvents'."]: + """Retrieve events for a specific subscription. + + Call this tool to retrieve all events related to a specific subscription using the Square API. Useful for tracking changes and updates within a subscription lifecycle.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/subscriptions/{subscription_id}/events".format( # noqa: UP032 + subscription_id=subscription_id + ), + method="GET", + params=remove_none_values({"cursor": pagination_cursor, "limit": max_events_per_page}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["EMPLOYEES_READ"])) +async def list_jobs_for_seller( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "The cursor for pagination to retrieve the next page of job results. Obtain this from the previous response.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListJobs'."]: + """Retrieve a list of jobs in a seller account. + + This tool retrieves a list of jobs associated with a seller account, sorted by title in ascending order. Use this tool when you need to view or manage the job listings for a seller.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/team-members/jobs", + method="GET", + params=remove_none_values({"cursor": pagination_cursor}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["EMPLOYEES_READ"])) +async def retrieve_job_details( + context: ToolContext, + job_identifier: Annotated[ + str, "The unique ID of the job to retrieve. This is required to fetch the job details." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveJob'."]: + """Retrieve details of a specified job by ID. + + Use this tool to get information about a specific job using its ID. It should be called when details about a particular job are needed, such as in management and administrative tasks.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/team-members/jobs/{job_id}".format( # noqa: UP032 + job_id=job_identifier + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["EMPLOYEES_READ"])) +async def retrieve_team_member_details( + context: ToolContext, + team_member_id: Annotated[ + str, + "The unique identifier of the team member whose details you want to retrieve. This ID is required to access specific team member information.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveTeamMember'."]: + """Retrieve details of a team member by ID. + + Use this tool to access detailed information about a specific team member using their unique ID. This is useful for managing or reviewing team member profiles.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/team-members/{team_member_id}".format( # noqa: UP032 + team_member_id=team_member_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["EMPLOYEES_READ"])) +async def retrieve_team_member_wage_setting( + context: ToolContext, + team_member_id: Annotated[ + str, "The unique identifier for the team member whose wage setting is to be retrieved." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveWageSetting'."]: + """Retrieve wage setting details for a specific team member. + + This tool retrieves the wage setting for a team member based on their ID. Use this when you need to access detailed wage information about a specific member. It is recommended to use RetrieveTeamMember or SearchTeamMembers for related queries.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/team-members/{team_member_id}/wage-setting".format( # noqa: UP032 + team_member_id=team_member_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_READ"])) +async def get_terminal_action( + context: ToolContext, + terminal_action_id: Annotated[ + str, + "Unique ID of the terminal action to retrieve. Must be provided to access the TerminalAction details.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetTerminalAction'."]: + """Retrieve details of a terminal action request by ID. + + This tool retrieves a Terminal action request using the specified `action_id`. Terminal action requests can be accessed within 30 days of their request.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/actions/{action_id}".format( # noqa: UP032 + action_id=terminal_action_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_WRITE"])) +async def cancel_terminal_action( + context: ToolContext, + terminal_action_id: Annotated[str, "Unique ID for the TerminalAction you want to cancel."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'CancelTerminalAction'."]: + """Cancel a terminal action request if permitted. + + Use this tool to cancel a terminal action request when the status allows for cancellation.""" + response = await make_request( + url="https://connect.squareup.com/v2/terminals/actions/{action_id}/cancel".format( # noqa: UP032 + action_id=terminal_action_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def dismiss_terminal_action( + context: ToolContext, + terminal_action_id: Annotated[ + str, "Unique ID for the TerminalAction associated with the action to be dismissed." + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DismissTerminalAction'."]: + """Dismiss a Square Terminal action request. + + Use this tool to dismiss a Terminal action request if it is permitted by the status and type of the request.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/actions/{action_id}/dismiss".format( # noqa: UP032 + action_id=terminal_action_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_READ"])) +async def retrieve_terminal_checkout( + context: ToolContext, + terminal_checkout_id: Annotated[ + str, + "The unique ID used to retrieve details of a Terminal checkout request. Valid for 30 days.", + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetTerminalCheckout'."]: + """Retrieve a Terminal checkout request by ID. + + This tool retrieves the details of a Terminal checkout request using a unique `checkout_id`. It should be called to access checkout information up to 30 days after the request was created.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/checkouts/{checkout_id}".format( # noqa: UP032 + checkout_id=terminal_checkout_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_WRITE"])) +async def cancel_terminal_checkout( + context: ToolContext, + terminal_checkout_id: Annotated[str, "The unique ID of the TerminalCheckout to be canceled."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'CancelTerminalCheckout'."]: + """Cancel a Terminal checkout request if feasible. + + This tool cancels a Terminal checkout request, if its current status allows cancellation. It should be called when a checkout process needs to be aborted.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/checkouts/{checkout_id}/cancel".format( # noqa: UP032 + checkout_id=terminal_checkout_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def dismiss_terminal_checkout( + context: ToolContext, + terminal_checkout_id: Annotated[str, "Unique ID for the TerminalCheckout to be dismissed."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DismissTerminalCheckout'."]: + """Dismiss a Terminal checkout request if permitted. + + Call this tool to dismiss a Terminal checkout request when the request status and type allow for dismissal. Useful for managing checkout operations and correcting errors in checkout processes.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/checkouts/{checkout_id}/dismiss".format( # noqa: UP032 + checkout_id=terminal_checkout_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_READ"])) +async def get_terminal_refund( + context: ToolContext, + terminal_refund_id: Annotated[ + str, + "The unique ID of the Interac Terminal refund to retrieve. Must be used within 30 days of creation.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'GetTerminalRefund'."]: + """Fetch Interac Terminal refund details by ID. + + Use this tool to retrieve details of an Interac Terminal refund within 30 days of its creation using the refund ID.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/refunds/{terminal_refund_id}".format( # noqa: UP032 + terminal_refund_id=terminal_refund_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["PAYMENTS_WRITE"])) +async def cancel_terminal_refund( + context: ToolContext, + terminal_refund_id: Annotated[str, "The unique ID for the desired TerminalRefund to cancel."], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'CancelTerminalRefund'."]: + """Cancel a terminal refund request if allowed. + + This tool cancels a terminal refund request using the refund request ID, if the current status permits cancellation.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/refunds/{terminal_refund_id}/cancel".format( # noqa: UP032 + terminal_refund_id=terminal_refund_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def dismiss_terminal_refund( + context: ToolContext, + terminal_refund_unique_id: Annotated[ + str, + "The unique identifier for the `TerminalRefund` that is associated with the refund to be dismissed.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DismissTerminalRefund'."]: + """Dismiss a Terminal refund request if permissible. + + Use this tool to dismiss a Terminal refund request when the request status and type allow for dismissal.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/terminals/refunds/{terminal_refund_id}/dismiss".format( # noqa: UP032 + terminal_refund_id=terminal_refund_unique_id + ), + method="POST", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup", scopes=["VENDOR_READ"])) +async def retrieve_vendor_info( + context: ToolContext, + vendor_id: Annotated[ + str, + "The ID of the vendor whose information you want to retrieve. This should be a unique string identifier.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveVendor'."]: + """Retrieve detailed information about a vendor by ID. + + This tool is used to fetch detailed information about a specific vendor using their Vendor ID. It is helpful when you need comprehensive vendor details.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/vendors/{vendor_id}".format(vendor_id=vendor_id), # noqa: UP032 + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def list_webhook_event_types( + context: ToolContext, + api_version: Annotated[ + str | None, + "Specify the API version to list event types. Overrides the default version if set.", + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListWebhookEventTypes'."]: + """Retrieves all available webhook event types for subscription. + + Use this tool to get a comprehensive list of webhook event types that can be subscribed to via the Square API.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/webhooks/event-types", + method="GET", + params=remove_none_values({"api_version": api_version}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def list_webhook_subscriptions( + context: ToolContext, + pagination_cursor: Annotated[ + str | None, + "A cursor for pagination to retrieve the next set of results from a previous query.", + ] = None, + sort_order: Annotated[ + str | None, + "Sorts the webhook subscriptions by creation date. Options are 'ASC' for ascending or 'DESC' for descending. Defaults to 'ASC'.", # noqa: E501 + ] = None, + max_results_per_page: Annotated[ + int | None, + "The maximum number of webhook subscription results to return in a single page (max: 100).", + ] = None, + include_disabled_subscriptions: Annotated[ + bool | None, + "Set to true to include disabled subscriptions in the results. By default, only enabled subscriptions are returned.", # noqa: E501 + ] = None, +) -> Annotated[dict[str, Any], "Response from the API endpoint 'ListWebhookSubscriptions'."]: + """Lists all webhook subscriptions for your application. + + Use this tool to retrieve a list of all webhook subscriptions owned by your application. It is useful for managing or reviewing your webhook configurations.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/webhooks/subscriptions", + method="GET", + params=remove_none_values({ + "cursor": pagination_cursor, + "include_disabled": include_disabled_subscriptions, + "sort_order": sort_order, + "limit": max_results_per_page, + }), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def delete_webhook_subscription( + context: ToolContext, + webhook_subscription_id: Annotated[ + str, + "The unique identifier for the webhook subscription to be deleted. This ID is required to identify the specific subscription.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'DeleteWebhookSubscription'."]: + """Deletes a webhook subscription to stop receiving events. + + Use this tool to delete a specific webhook subscription by its ID, preventing further event notifications.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/webhooks/subscriptions/{subscription_id}".format( # noqa: UP032 + subscription_id=webhook_subscription_id + ), + method="DELETE", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} + + +@tool(requires_auth=OAuth2(id="arcade-squareup")) +async def retrieve_webhook_subscription( + context: ToolContext, + webhook_subscription_id: Annotated[ + str, + "The unique identifier of the webhook subscription to be retrieved. This is a required parameter.", # noqa: E501 + ], +) -> Annotated[dict[str, Any], "Response from the API endpoint 'RetrieveWebhookSubscription'."]: + """Retrieve details of a specific webhook subscription by ID. + + Use this tool to fetch information about a webhook subscription using its unique identifier. This is useful when you need to verify the configuration or details of a specific webhook subscription.""" # noqa: E501 + response = await make_request( + url="https://connect.squareup.com/v2/webhooks/subscriptions/{subscription_id}".format( # noqa: UP032 + subscription_id=webhook_subscription_id + ), + method="GET", + params=remove_none_values({}), + headers=remove_none_values({ + "Authorization": "Bearer {authorization}".format( # noqa: UP032 + authorization=context.get_auth_token_or_empty() + ) + }), + data=remove_none_values({}), + ) + try: + return {"response_json": response.json()} + except Exception: + return {"response_text": response.text} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AcceptDispute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AcceptDispute.json new file mode 100644 index 00000000..459869ec --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AcceptDispute.json @@ -0,0 +1,105 @@ +{ + "name": "AcceptDispute", + "fully_qualified_name": "SquareupApi.AcceptDispute@0.1.0", + "description": "Accepts the loss on a dispute, updating the state to ACCEPTED.\n\nThis tool accepts the loss on a dispute by updating its state to ACCEPTED. Square processes the disputed amount, returning it to the cardholder and debiting the seller's Square account or associated bank account if funds are insufficient.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "dispute_id", + "required": true, + "description": "The unique identifier for the dispute that needs to be accepted. This must match the ID given by Square for the specific dispute.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute you want to accept." + }, + "inferrable": true, + "http_endpoint_parameter_name": "dispute_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'AcceptDispute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DISPUTES_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/disputes/{dispute_id}/accept", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "dispute_id", + "tool_parameter_name": "dispute_id", + "description": "The ID of the dispute you want to accept.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute you want to accept." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AddGroupToCustomer.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AddGroupToCustomer.json new file mode 100644 index 00000000..9d67151b --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/AddGroupToCustomer.json @@ -0,0 +1,137 @@ +{ + "name": "AddGroupToCustomer", + "fully_qualified_name": "SquareupApi.AddGroupToCustomer@0.1.0", + "description": "Add a customer to a specific group.\n\nUse this tool to assign a specified customer to a particular group by providing the customer's ID and the group's ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_id", + "required": true, + "description": "The unique identifier for the customer to be added to a group. It must match an existing customer ID.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to add to a group." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "customer_group_id", + "required": true, + "description": "The ID of the customer group to which the customer will be added. This should be a valid group ID.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to add the customer to." + }, + "inferrable": true, + "http_endpoint_parameter_name": "group_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'AddGroupToCustomer'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/{customer_id}/groups/{group_id}", + "http_method": "PUT", + "headers": {}, + "parameters": [ + { + "name": "customer_id", + "tool_parameter_name": "customer_id", + "description": "The ID of the customer to add to a group.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to add to a group." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "group_id", + "tool_parameter_name": "customer_group_id", + "description": "The ID of the customer group to add the customer to.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to add the customer to." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelApprovedPayment.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelApprovedPayment.json new file mode 100644 index 00000000..9f800443 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelApprovedPayment.json @@ -0,0 +1,105 @@ +{ + "name": "CancelApprovedPayment", + "fully_qualified_name": "SquareupApi.CancelApprovedPayment@0.1.0", + "description": "Cancel an approved payment transaction.\n\nUse this tool to void a payment that has an APPROVED status. This can be useful when a transaction needs to be reversed before completion.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "payment_identifier", + "required": true, + "description": "The unique ID of the payment to cancel. This ID must correspond to a payment with an APPROVED status.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payment to cancel." + }, + "inferrable": true, + "http_endpoint_parameter_name": "payment_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'CancelPayment'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/payments/{payment_id}/cancel", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "payment_id", + "tool_parameter_name": "payment_identifier", + "description": "The ID of the payment to cancel.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payment to cancel." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelLoyaltyPromotion.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelLoyaltyPromotion.json new file mode 100644 index 00000000..0d479b00 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelLoyaltyPromotion.json @@ -0,0 +1,137 @@ +{ + "name": "CancelLoyaltyPromotion", + "fully_qualified_name": "SquareupApi.CancelLoyaltyPromotion@0.1.0", + "description": "Cancel an active or scheduled loyalty promotion early.\n\nUse this tool to set a loyalty promotion to the 'CANCELED' state. It is useful for canceling active promotions earlier than planned or canceling scheduled promotions before they begin. This is also applicable if you need to cancel one prior to creating a new promotion.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "loyalty_promotion_id", + "required": true, + "description": "The unique identifier of the loyalty promotion to be canceled. Applicable for promotions with an 'ACTIVE' or 'SCHEDULED' status.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty promotion](entity:LoyaltyPromotion) to cancel. You can cancel a\npromotion that has an `ACTIVE` or `SCHEDULED` status." + }, + "inferrable": true, + "http_endpoint_parameter_name": "promotion_id" + }, + { + "name": "loyalty_program_id", + "required": true, + "description": "The unique ID of the base loyalty program to be canceled.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "program_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'CancelLoyaltyPromotion'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "LOYALTY_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/loyalty/programs/{program_id}/promotions/{promotion_id}/cancel", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "promotion_id", + "tool_parameter_name": "loyalty_promotion_id", + "description": "The ID of the [loyalty promotion](entity:LoyaltyPromotion) to cancel. You can cancel a\npromotion that has an `ACTIVE` or `SCHEDULED` status.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty promotion](entity:LoyaltyPromotion) to cancel. You can cancel a\npromotion that has an `ACTIVE` or `SCHEDULED` status." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "program_id", + "tool_parameter_name": "loyalty_program_id", + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelSubscription.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelSubscription.json new file mode 100644 index 00000000..fefd88dd --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelSubscription.json @@ -0,0 +1,105 @@ +{ + "name": "CancelSubscription", + "fully_qualified_name": "SquareupApi.CancelSubscription@0.1.0", + "description": "Schedule cancellation of an active subscription.\n\nUse this tool to schedule a cancellation for an active subscription. The subscription will remain active until the end of the current billing period, after which it will be marked as canceled.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "subscription_identifier", + "required": true, + "description": "The unique identifier of the subscription to be canceled. Required to schedule the cancellation.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription to cancel." + }, + "inferrable": true, + "http_endpoint_parameter_name": "subscription_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'CancelSubscription'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "SUBSCRIPTIONS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/subscriptions/{subscription_id}/cancel", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "subscription_id", + "tool_parameter_name": "subscription_identifier", + "description": "The ID of the subscription to cancel.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription to cancel." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalAction.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalAction.json new file mode 100644 index 00000000..5d81c526 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalAction.json @@ -0,0 +1,105 @@ +{ + "name": "CancelTerminalAction", + "fully_qualified_name": "SquareupApi.CancelTerminalAction@0.1.0", + "description": "Cancel a terminal action request if permitted.\n\nUse this tool to cancel a terminal action request when the status allows for cancellation.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_action_id", + "required": true, + "description": "Unique ID for the TerminalAction you want to cancel.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired `TerminalAction`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "action_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'CancelTerminalAction'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/actions/{action_id}/cancel", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "action_id", + "tool_parameter_name": "terminal_action_id", + "description": "Unique ID for the desired `TerminalAction`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired `TerminalAction`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalCheckout.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalCheckout.json new file mode 100644 index 00000000..6abcf77b --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalCheckout.json @@ -0,0 +1,105 @@ +{ + "name": "CancelTerminalCheckout", + "fully_qualified_name": "SquareupApi.CancelTerminalCheckout@0.1.0", + "description": "Cancel a Terminal checkout request if feasible.\n\nThis tool cancels a Terminal checkout request, if its current status allows cancellation. It should be called when a checkout process needs to be aborted.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_checkout_id", + "required": true, + "description": "The unique ID of the TerminalCheckout to be canceled.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalCheckout`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "checkout_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'CancelTerminalCheckout'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/checkouts/{checkout_id}/cancel", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "checkout_id", + "tool_parameter_name": "terminal_checkout_id", + "description": "The unique ID for the desired `TerminalCheckout`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalCheckout`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalRefund.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalRefund.json new file mode 100644 index 00000000..35f1ccb5 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/CancelTerminalRefund.json @@ -0,0 +1,105 @@ +{ + "name": "CancelTerminalRefund", + "fully_qualified_name": "SquareupApi.CancelTerminalRefund@0.1.0", + "description": "Cancel a terminal refund request if allowed.\n\nThis tool cancels a terminal refund request using the refund request ID, if the current status permits cancellation.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_refund_id", + "required": true, + "description": "The unique ID for the desired TerminalRefund to cancel.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalRefund`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "terminal_refund_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'CancelTerminalRefund'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/refunds/{terminal_refund_id}/cancel", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "terminal_refund_id", + "tool_parameter_name": "terminal_refund_id", + "description": "The unique ID for the desired `TerminalRefund`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalRefund`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttribute.json new file mode 100644 index 00000000..c33c9149 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttribute.json @@ -0,0 +1,137 @@ +{ + "name": "DeleteBookingCustomAttribute", + "fully_qualified_name": "SquareupApi.DeleteBookingCustomAttribute@0.1.0", + "description": "Deletes a custom attribute from a booking.\n\nUse this tool to remove a custom attribute from a specific booking. Appropriate OAuth permissions are required: 'APPOINTMENTS_WRITE' for buyer-level and 'APPOINTMENTS_ALL_WRITE' with 'APPOINTMENTS_WRITE' for seller-level. Seller must be subscribed to Appointments Plus or Premium.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "booking_id", + "required": true, + "description": "The ID of the target booking from which the custom attribute will be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [booking](entity:Booking)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "booking_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute to delete. It must match the key of a custom attribute definition in the Square seller account. Use the qualified key if not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteBookingCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/{booking_id}/custom-attributes/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "booking_id", + "tool_parameter_name": "booking_id", + "description": "The ID of the target [booking](entity:Booking).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [booking](entity:Booking)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttributeDefinition.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttributeDefinition.json new file mode 100644 index 00000000..e0649e74 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBookingCustomAttributeDefinition.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteBookingCustomAttributeDefinition", + "fully_qualified_name": "SquareupApi.DeleteBookingCustomAttributeDefinition@0.1.0", + "description": "Deletes a bookings custom attribute definition.\n\nUse to delete a custom attribute definition for bookings. Requires specific OAuth scopes depending on permission level: `APPOINTMENTS_WRITE` for buyer-level or both `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for seller-level. Seller-level calls require an Appointments Plus or Premium subscription.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_definition_key", + "required": true, + "description": "The unique key of the custom attribute definition to be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteBookingCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/custom-attribute-definitions/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "key", + "tool_parameter_name": "custom_attribute_definition_key", + "description": "The key of the custom attribute definition to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBreakType.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBreakType.json new file mode 100644 index 00000000..dc7622e1 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteBreakType.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteBreakType", + "fully_qualified_name": "SquareupApi.DeleteBreakType@0.1.0", + "description": "Deletes an existing break type.\n\nUse this tool to delete a specific break type, even if it is referenced by a shift.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "break_type_uuid", + "required": true, + "description": "The UUID of the BreakType to delete. Ensure it is a valid UUID format.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `BreakType` being deleted." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteBreakType'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "TIMECARDS_SETTINGS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/break-types/{id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "break_type_uuid", + "description": "The UUID for the `BreakType` being deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `BreakType` being deleted." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCatalogObject.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCatalogObject.json new file mode 100644 index 00000000..2b19f430 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCatalogObject.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteCatalogObject", + "fully_qualified_name": "SquareupApi.DeleteCatalogObject@0.1.0", + "description": "Deletes a catalog object and its children by ID.\n\nThis tool deletes a catalog object by its ID, including all its child objects, ensuring that only one delete request is processed at a time per seller account. It should be called when you want to permanently remove a catalog item and its variations.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "catalog_object_id", + "required": true, + "description": "The ID of the catalog object, including its child objects, to be deleted. This is a cascading deletion.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the catalog object to be deleted. When an object is deleted, other\nobjects in the graph that depend on that object will be deleted as well (for example, deleting a\ncatalog item will delete its catalog item variations)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "object_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteCatalogObject'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ITEMS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/catalog/object/{object_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "object_id", + "tool_parameter_name": "catalog_object_id", + "description": "The ID of the catalog object to be deleted. When an object is deleted, other\nobjects in the graph that depend on that object will be deleted as well (for example, deleting a\ncatalog item will delete its catalog item variations).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the catalog object to be deleted. When an object is deleted, other\nobjects in the graph that depend on that object will be deleted as well (for example, deleting a\ncatalog item will delete its catalog item variations)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttribute.json new file mode 100644 index 00000000..e3dddee0 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttribute.json @@ -0,0 +1,137 @@ +{ + "name": "DeleteCustomerCustomAttribute", + "fully_qualified_name": "SquareupApi.DeleteCustomerCustomAttribute@0.1.0", + "description": "Delete a custom attribute from a customer profile.\n\nDeletes a custom attribute from a customer profile, ensuring the visibility setting is `VISIBILITY_READ_WRITE_VALUES` for attributes owned by other applications.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_profile_id", + "required": true, + "description": "The ID of the target customer profile for which the custom attribute will be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [customer profile](entity:Customer)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key identifying the custom attribute to delete, matching the definition in the Square account. Use the qualified key if the application isn't the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteCustomerCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/{customer_id}/custom-attributes/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "customer_id", + "tool_parameter_name": "customer_profile_id", + "description": "The ID of the target [customer profile](entity:Customer).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [customer profile](entity:Customer)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttributeDefinition.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttributeDefinition.json new file mode 100644 index 00000000..3f6d81ed --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerCustomAttributeDefinition.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteCustomerCustomAttributeDefinition", + "fully_qualified_name": "SquareupApi.DeleteCustomerCustomAttributeDefinition@0.1.0", + "description": "Delete a customer custom attribute definition for a seller account.\n\nThis tool deletes a customer-related custom attribute definition from a Square seller's account. It will also remove the related custom attribute from all customer profiles in the seller's Customer Directory. Only the definition owner can perform this action.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_key", + "required": true, + "description": "The unique key of the custom attribute definition you wish to delete from the seller account.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteCustomerCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/custom-attribute-definitions/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute definition to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerGroup.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerGroup.json new file mode 100644 index 00000000..a8325b0e --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerGroup.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteCustomerGroup", + "fully_qualified_name": "SquareupApi.DeleteCustomerGroup@0.1.0", + "description": "Deletes a specified customer group by ID.\n\n", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_group_id", + "required": true, + "description": "The ID of the customer group to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "group_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteCustomerGroup'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/groups/{group_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "group_id", + "tool_parameter_name": "customer_group_id", + "description": "The ID of the customer group to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerProfile.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerProfile.json new file mode 100644 index 00000000..a1195cc3 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteCustomerProfile.json @@ -0,0 +1,137 @@ +{ + "name": "DeleteCustomerProfile", + "fully_qualified_name": "SquareupApi.DeleteCustomerProfile@0.1.0", + "description": "Deletes a customer profile from a business.\n\nUse this tool to delete a customer profile, especially if created by merging existing profiles. The unique customer ID is required for deletion.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_identifier", + "required": true, + "description": "The unique identifier of the customer to be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "customer_profile_version", + "required": false, + "description": "The current version of the customer profile. Used for optimistic concurrency control.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the customer profile.\n\nAs a best practice, you should include this parameter to enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency) control. For more information, see [Delete a customer profile](https://developer.squareup.com/docs/customers-api/use-the-api/keep-records#delete-customer-profile)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteCustomer'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/{customer_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "customer_profile_version", + "description": "The current version of the customer profile.\n\nAs a best practice, you should include this parameter to enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency) control. For more information, see [Delete a customer profile](https://developer.squareup.com/docs/customers-api/use-the-api/keep-records#delete-customer-profile).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the customer profile.\n\nAs a best practice, you should include this parameter to enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency) control. For more information, see [Delete a customer profile](https://developer.squareup.com/docs/customers-api/use-the-api/keep-records#delete-customer-profile)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "customer_id", + "tool_parameter_name": "customer_identifier", + "description": "The ID of the customer to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteDraftInvoice.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteDraftInvoice.json new file mode 100644 index 00000000..a9ac8995 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteDraftInvoice.json @@ -0,0 +1,138 @@ +{ + "name": "DeleteDraftInvoice", + "fully_qualified_name": "SquareupApi.DeleteDraftInvoice@0.1.0", + "description": "Deletes a specified draft invoice.\n\nUse this tool to delete a draft invoice. Once deleted, the associated order status changes to CANCELED. This tool cannot delete published invoices.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "invoice_id_to_delete", + "required": true, + "description": "The ID of the draft invoice to be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the invoice to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "invoice_id" + }, + { + "name": "invoice_version_to_delete", + "required": false, + "description": "The version number of the draft invoice to delete. Retrieve this using GetInvoice or ListInvoices if unknown.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The version of the [invoice](entity:Invoice) to delete.\nIf you do not know the version, you can call [GetInvoice](api-endpoint:Invoices-GetInvoice) or \n[ListInvoices](api-endpoint:Invoices-ListInvoices)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteInvoice'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_WRITE", + "INVOICES_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/invoices/{invoice_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "invoice_version_to_delete", + "description": "The version of the [invoice](entity:Invoice) to delete.\nIf you do not know the version, you can call [GetInvoice](api-endpoint:Invoices-GetInvoice) or \n[ListInvoices](api-endpoint:Invoices-ListInvoices).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The version of the [invoice](entity:Invoice) to delete.\nIf you do not know the version, you can call [GetInvoice](api-endpoint:Invoices-GetInvoice) or \n[ListInvoices](api-endpoint:Invoices-ListInvoices)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "invoice_id", + "tool_parameter_name": "invoice_id_to_delete", + "description": "The ID of the invoice to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the invoice to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLocationCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLocationCustomAttribute.json new file mode 100644 index 00000000..77f534b8 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLocationCustomAttribute.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteLocationCustomAttribute", + "fully_qualified_name": "SquareupApi.DeleteLocationCustomAttribute@0.1.0", + "description": "Delete a location-related custom attribute definition.\n\nUse this tool to delete a specific location-related custom attribute definition from a Square seller account. Only the definition owner can perform this action. Deleting also removes the attribute from all locations.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_key", + "required": true, + "description": "The unique key identifying the custom attribute definition to be deleted from the seller account.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteLocationCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations/custom-attribute-definitions/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute definition to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLoyaltyReward.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLoyaltyReward.json new file mode 100644 index 00000000..74429b5f --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteLoyaltyReward.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteLoyaltyReward", + "fully_qualified_name": "SquareupApi.DeleteLoyaltyReward@0.1.0", + "description": "Delete a loyalty reward and restore loyalty points.\n\nUse this tool to delete a loyalty reward, which restores loyalty points to the account. It also updates the associated order by removing the reward and related discounts if an order ID was specified. The reward cannot be deleted if it has been redeemed.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "reward_id", + "required": true, + "description": "The ID of the loyalty reward to delete. This is required to identify which reward to remove and restore points for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty reward](entity:LoyaltyReward) to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "reward_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteLoyaltyReward'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "LOYALTY_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/loyalty/rewards/{reward_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "reward_id", + "tool_parameter_name": "reward_id", + "description": "The ID of the [loyalty reward](entity:LoyaltyReward) to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty reward](entity:LoyaltyReward) to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteMerchantCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteMerchantCustomAttribute.json new file mode 100644 index 00000000..78011d89 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteMerchantCustomAttribute.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteMerchantCustomAttribute", + "fully_qualified_name": "SquareupApi.DeleteMerchantCustomAttribute@0.1.0", + "description": "Delete a custom attribute definition from a merchant account.\n\nUse this tool to delete a merchant-related custom attribute definition from a Square seller account. This action also removes the corresponding custom attribute from the merchant. Note that only the definition owner can perform this deletion.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "attribute_key_to_delete", + "required": true, + "description": "The key of the custom attribute definition to delete from the merchant account.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteMerchantCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants/custom-attribute-definitions/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "key", + "tool_parameter_name": "attribute_key_to_delete", + "description": "The key of the custom attribute definition to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttribute.json new file mode 100644 index 00000000..409c292f --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttribute.json @@ -0,0 +1,137 @@ +{ + "name": "DeleteOrderCustomAttribute", + "fully_qualified_name": "SquareupApi.DeleteOrderCustomAttribute@0.1.0", + "description": "Delete a custom attribute from an order.\n\nUse this tool to delete a specific custom attribute associated with an order. This is necessary when a custom attribute has the 'VISIBILITY_READ_WRITE_VALUES' setting or is defined by the seller.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "order_id", + "required": true, + "description": "The unique identifier for the target order from which the custom attribute will be deleted. This ID is crucial for locating the correct order.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [order](entity:Order)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "order_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "Specifies the key of the custom attribute to be deleted. It must match an existing custom attribute definition's key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the key of an\nexisting custom attribute definition." + }, + "inferrable": true, + "http_endpoint_parameter_name": "custom_attribute_key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteOrderCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/orders/{order_id}/custom-attributes/{custom_attribute_key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "order_id", + "tool_parameter_name": "order_id", + "description": "The ID of the target [order](entity:Order).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [order](entity:Order)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "custom_attribute_key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to delete. This key must match the key of an\nexisting custom attribute definition.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the key of an\nexisting custom attribute definition." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttributeDefinition.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttributeDefinition.json new file mode 100644 index 00000000..a0ba4a9c --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteOrderCustomAttributeDefinition.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteOrderCustomAttributeDefinition", + "fully_qualified_name": "SquareupApi.DeleteOrderCustomAttributeDefinition@0.1.0", + "description": "Delete an order-related custom attribute definition.\n\nDeletes a custom attribute definition related to an order from a Square seller account. Only the owner of the definition can perform this action.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_key", + "required": true, + "description": "The key identifying the custom attribute definition to be deleted from the seller's account.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteOrderCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/orders/custom-attribute-definitions/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute definition to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeletePaymentLink.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeletePaymentLink.json new file mode 100644 index 00000000..a595a9c5 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeletePaymentLink.json @@ -0,0 +1,106 @@ +{ + "name": "DeletePaymentLink", + "fully_qualified_name": "SquareupApi.DeletePaymentLink@0.1.0", + "description": "Deletes a specified payment link.\n\nUse this tool to delete a payment link by providing the link's ID. Call it when you need to remove a payment link from your system.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "payment_link_id", + "required": true, + "description": "The ID of the payment link you want to delete. Provide the specific link ID to proceed with deletion.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payment link to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeletePaymentLink'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_WRITE", + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/online-checkout/payment-links/{id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "payment_link_id", + "description": "The ID of the payment link to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payment link to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteSubscriptionAction.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteSubscriptionAction.json new file mode 100644 index 00000000..3a6910ad --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteSubscriptionAction.json @@ -0,0 +1,137 @@ +{ + "name": "DeleteSubscriptionAction", + "fully_qualified_name": "SquareupApi.DeleteSubscriptionAction@0.1.0", + "description": "Delete a scheduled action from a subscription.\n\nThis tool deletes a specific scheduled action associated with a subscription identified by its subscription and action IDs. Use it to cancel or remove actions that are no longer needed from a subscription plan.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "subscription_id", + "required": true, + "description": "The ID of the subscription for which the action is to be deleted. This ID is required to identify the specific subscription being targeted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription the targeted action is to act upon." + }, + "inferrable": true, + "http_endpoint_parameter_name": "subscription_id" + }, + { + "name": "action_id", + "required": true, + "description": "The ID of the specific action to be deleted from a subscription.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the targeted action to be deleted." + }, + "inferrable": true, + "http_endpoint_parameter_name": "action_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteSubscriptionAction'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "SUBSCRIPTIONS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/subscriptions/{subscription_id}/actions/{action_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "subscription_id", + "tool_parameter_name": "subscription_id", + "description": "The ID of the subscription the targeted action is to act upon.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription the targeted action is to act upon." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "action_id", + "tool_parameter_name": "action_id", + "description": "The ID of the targeted action to be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the targeted action to be deleted." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteTimecard.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteTimecard.json new file mode 100644 index 00000000..f4d879ad --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteTimecard.json @@ -0,0 +1,105 @@ +{ + "name": "DeleteTimecard", + "fully_qualified_name": "SquareupApi.DeleteTimecard@0.1.0", + "description": "Deletes a specified timecard.\n\nUse this tool to delete a timecard by its ID when managing labor records.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "timecard_id", + "required": true, + "description": "The UUID for the timecard to be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `Timecard` being deleted." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteTimecard'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "TIMECARDS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/timecards/{id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "timecard_id", + "description": "The UUID for the `Timecard` being deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `Timecard` being deleted." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteWebhookSubscription.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteWebhookSubscription.json new file mode 100644 index 00000000..c6e73231 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DeleteWebhookSubscription.json @@ -0,0 +1,101 @@ +{ + "name": "DeleteWebhookSubscription", + "fully_qualified_name": "SquareupApi.DeleteWebhookSubscription@0.1.0", + "description": "Deletes a webhook subscription to stop receiving events.\n\nUse this tool to delete a specific webhook subscription by its ID, preventing further event notifications.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "webhook_subscription_id", + "required": true, + "description": "The unique identifier for the webhook subscription to be deleted. This ID is required to identify the specific subscription.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "[REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "subscription_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteWebhookSubscription'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/webhooks/subscriptions/{subscription_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "subscription_id", + "tool_parameter_name": "webhook_subscription_id", + "description": "[REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "[REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisableEventsSearch.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisableEventsSearch.json new file mode 100644 index 00000000..53c97bf6 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisableEventsSearch.json @@ -0,0 +1,67 @@ +{ + "name": "DisableEventsSearch", + "fully_qualified_name": "SquareupApi.DisableEventsSearch@0.1.0", + "description": "Disable events to prevent them from being searchable.\n\nUse this tool to disable events, preventing them from being searchable, even if re-enabled later. Helpful for managing event visibility.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'DisableEvents'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/events/disable", + "http_method": "PUT", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisablePaymentCard.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisablePaymentCard.json new file mode 100644 index 00000000..c0140c08 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DisablePaymentCard.json @@ -0,0 +1,101 @@ +{ + "name": "DisablePaymentCard", + "fully_qualified_name": "SquareupApi.DisablePaymentCard@0.1.0", + "description": "Disable a payment card to prevent charges.\n\nUse this tool to disable a payment card, stopping any further updates or charges. Disabling an already disabled card is permitted but will not have any additional effect.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "payment_card_id", + "required": true, + "description": "Unique ID for the card to be disabled.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired Card." + }, + "inferrable": true, + "http_endpoint_parameter_name": "card_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DisableCard'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/cards/{card_id}/disable", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "card_id", + "tool_parameter_name": "payment_card_id", + "description": "Unique ID for the desired Card.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired Card." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalAction.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalAction.json new file mode 100644 index 00000000..99c1e27e --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalAction.json @@ -0,0 +1,101 @@ +{ + "name": "DismissTerminalAction", + "fully_qualified_name": "SquareupApi.DismissTerminalAction@0.1.0", + "description": "Dismiss a Square Terminal action request.\n\nUse this tool to dismiss a Terminal action request if it is permitted by the status and type of the request.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_action_id", + "required": true, + "description": "Unique ID for the TerminalAction associated with the action to be dismissed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the `TerminalAction` associated with the action to be dismissed." + }, + "inferrable": true, + "http_endpoint_parameter_name": "action_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DismissTerminalAction'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/actions/{action_id}/dismiss", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "action_id", + "tool_parameter_name": "terminal_action_id", + "description": "Unique ID for the `TerminalAction` associated with the action to be dismissed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the `TerminalAction` associated with the action to be dismissed." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalCheckout.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalCheckout.json new file mode 100644 index 00000000..62a96b04 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalCheckout.json @@ -0,0 +1,101 @@ +{ + "name": "DismissTerminalCheckout", + "fully_qualified_name": "SquareupApi.DismissTerminalCheckout@0.1.0", + "description": "Dismiss a Terminal checkout request if permitted.\n\nCall this tool to dismiss a Terminal checkout request when the request status and type allow for dismissal. Useful for managing checkout operations and correcting errors in checkout processes.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_checkout_id", + "required": true, + "description": "Unique ID for the TerminalCheckout to be dismissed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the `TerminalCheckout` associated with the checkout to be dismissed." + }, + "inferrable": true, + "http_endpoint_parameter_name": "checkout_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DismissTerminalCheckout'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/checkouts/{checkout_id}/dismiss", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "checkout_id", + "tool_parameter_name": "terminal_checkout_id", + "description": "Unique ID for the `TerminalCheckout` associated with the checkout to be dismissed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the `TerminalCheckout` associated with the checkout to be dismissed." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalRefund.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalRefund.json new file mode 100644 index 00000000..12602a29 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/DismissTerminalRefund.json @@ -0,0 +1,101 @@ +{ + "name": "DismissTerminalRefund", + "fully_qualified_name": "SquareupApi.DismissTerminalRefund@0.1.0", + "description": "Dismiss a Terminal refund request if permissible.\n\nUse this tool to dismiss a Terminal refund request when the request status and type allow for dismissal.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_refund_unique_id", + "required": true, + "description": "The unique identifier for the `TerminalRefund` that is associated with the refund to be dismissed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the `TerminalRefund` associated with the refund to be dismissed." + }, + "inferrable": true, + "http_endpoint_parameter_name": "terminal_refund_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DismissTerminalRefund'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/refunds/{terminal_refund_id}/dismiss", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "terminal_refund_id", + "tool_parameter_name": "terminal_refund_unique_id", + "description": "Unique ID for the `TerminalRefund` associated with the refund to be dismissed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the `TerminalRefund` associated with the refund to be dismissed." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/EnableEventsForSearch.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/EnableEventsForSearch.json new file mode 100644 index 00000000..a52d4f77 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/EnableEventsForSearch.json @@ -0,0 +1,67 @@ +{ + "name": "EnableEventsForSearch", + "fully_qualified_name": "SquareupApi.EnableEventsForSearch@0.1.0", + "description": "Enable events to make them searchable.\n\nThis tool activates events so that they become searchable. Only events occurring while enabled will be searchable. Use this tool when you need to ensure events are indexed for search.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'EnableEvents'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/events/enable", + "http_method": "PUT", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchPaymentList.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchPaymentList.json new file mode 100644 index 00000000..110f3792 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchPaymentList.json @@ -0,0 +1,561 @@ +{ + "name": "FetchPaymentList", + "fully_qualified_name": "SquareupApi.FetchPaymentList@0.1.0", + "description": "Retrieve a list of payments for an account.\n\nThis tool calls the Squareup API to fetch a list of payments associated with the account making the request. It should be called when you need to access recent payment records. Note that results are eventually consistent, and there may be slight delays in updates.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "start_time_for_payment_retrieval", + "required": false, + "description": "The start time for retrieving payments, in RFC 3339 format, using the `created_at` field. Default is current time minus one year.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve payments for, in RFC 3339 format.\nThe range is determined using the `created_at` field for each Payment.\nInclusive. Default: The current time minus one year." + }, + "inferrable": true, + "http_endpoint_parameter_name": "begin_time" + }, + { + "name": "payment_retrieval_end_time", + "required": false, + "description": "The end of the time range to retrieve payments, in RFC 3339 format. Defaults to the current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `created_at` field for each Payment.\n\nDefault: The current time." + }, + "inferrable": true, + "http_endpoint_parameter_name": "end_time" + }, + { + "name": "order_results_by", + "required": false, + "description": "Specify the order of payment results: 'ASC' for oldest to newest, 'DESC' for newest to oldest (default).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The order in which results are listed by `ListPaymentsRequest.sort_field`:\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A cursor from a previous call for fetching the next set of payment results. Use it for pagination.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "limit_results_by_location", + "required": false, + "description": "Specify the location ID to limit payment results to that location. Defaults to the main seller location if not provided.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to the location supplied. By default, results are returned\nfor the default (main) location associated with the seller." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "exact_payment_amount", + "required": false, + "description": "The exact amount of the payment in the total_money field. Provide as an integer value.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The exact amount in the `total_money` for a payment." + }, + "inferrable": true, + "http_endpoint_parameter_name": "total" + }, + { + "name": "payment_card_last_four_digits", + "required": false, + "description": "The last four digits of a payment card to filter specific payments.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The last four digits of a payment card." + }, + "inferrable": true, + "http_endpoint_parameter_name": "last_4" + }, + { + "name": "payment_card_brand", + "required": false, + "description": "The brand of the payment card to filter payments by (e.g., VISA, MasterCard).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The brand of the payment card (for example, VISA)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "card_brand" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "Specify the maximum number of payment records to return per page, up to 100. Values over 100 are ignored.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\n\nThe default value of 100 is also the maximum allowed value. If the provided value is \ngreater than 100, it is ignored and the default value is used instead.\n\nDefault: `100`" + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "offline_payment_start_time", + "required": false, + "description": "Indicate the start of the time range for retrieving offline payments in RFC 3339 format. Defaults to the current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range for which to retrieve offline payments, in RFC 3339\nformat for timestamps. The range is determined using the\n`offline_payment_details.client_created_at` field for each Payment. If set, payments without a\nvalue set in `offline_payment_details.client_created_at` will not be returned.\n\nDefault: The current time." + }, + "inferrable": true, + "http_endpoint_parameter_name": "offline_begin_time" + }, + { + "name": "offline_payment_end_time", + "required": false, + "description": "End time in RFC 3339 format to retrieve offline payments, based on `client_created_at`. Defaults to current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range for which to retrieve offline payments, in RFC 3339\nformat for timestamps. The range is determined using the\n`offline_payment_details.client_created_at` field for each Payment. If set, payments without a\nvalue set in `offline_payment_details.client_created_at` will not be returned.\n\nDefault: The current time." + }, + "inferrable": true, + "http_endpoint_parameter_name": "offline_end_time" + }, + { + "name": "updated_at_start_time", + "required": false, + "description": "Start time in RFC 3339 format to retrieve payments using the `updated_at` field.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `updated_at` field for each Payment." + }, + "inferrable": true, + "http_endpoint_parameter_name": "updated_at_begin_time" + }, + { + "name": "end_time_for_update_retrieval", + "required": false, + "description": "The end time in RFC 3339 format to filter payments by the `updated_at` field.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `updated_at` field for each Payment." + }, + "inferrable": true, + "http_endpoint_parameter_name": "updated_at_end_time" + }, + { + "name": "sort_results_by_field", + "required": false, + "description": "Specify the field to sort the payment results by. Options are 'CREATED_AT', 'OFFLINE_CREATED_AT', or 'UPDATED_AT'. Default is 'CREATED_AT'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "CREATED_AT", + "OFFLINE_CREATED_AT", + "UPDATED_AT" + ], + "properties": null, + "inner_properties": null, + "description": "The field used to sort results by. The default is `CREATED_AT`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_field" + }, + { + "name": "include_offline_payments", + "required": false, + "description": "Set to true to include payments taken offline. False excludes them.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Whether the payment was taken offline or not." + }, + "inferrable": true, + "http_endpoint_parameter_name": "is_offline_payment" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListPayments'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/payments", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "begin_time", + "tool_parameter_name": "start_time_for_payment_retrieval", + "description": "Indicates the start of the time range to retrieve payments for, in RFC 3339 format.\nThe range is determined using the `created_at` field for each Payment.\nInclusive. Default: The current time minus one year.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve payments for, in RFC 3339 format.\nThe range is determined using the `created_at` field for each Payment.\nInclusive. Default: The current time minus one year." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "end_time", + "tool_parameter_name": "payment_retrieval_end_time", + "description": "Indicates the end of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `created_at` field for each Payment.\n\nDefault: The current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `created_at` field for each Payment.\n\nDefault: The current time." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "order_results_by", + "description": "The order in which results are listed by `ListPaymentsRequest.sort_field`:\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The order in which results are listed by `ListPaymentsRequest.sort_field`:\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "limit_results_by_location", + "description": "Limit results to the location supplied. By default, results are returned\nfor the default (main) location associated with the seller.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to the location supplied. By default, results are returned\nfor the default (main) location associated with the seller." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "total", + "tool_parameter_name": "exact_payment_amount", + "description": "The exact amount in the `total_money` for a payment.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The exact amount in the `total_money` for a payment." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "last_4", + "tool_parameter_name": "payment_card_last_four_digits", + "description": "The last four digits of a payment card.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The last four digits of a payment card." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "card_brand", + "tool_parameter_name": "payment_card_brand", + "description": "The brand of the payment card (for example, VISA).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The brand of the payment card (for example, VISA)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\n\nThe default value of 100 is also the maximum allowed value. If the provided value is \ngreater than 100, it is ignored and the default value is used instead.\n\nDefault: `100`", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\n\nThe default value of 100 is also the maximum allowed value. If the provided value is \ngreater than 100, it is ignored and the default value is used instead.\n\nDefault: `100`" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "is_offline_payment", + "tool_parameter_name": "include_offline_payments", + "description": "Whether the payment was taken offline or not.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Whether the payment was taken offline or not." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "offline_begin_time", + "tool_parameter_name": "offline_payment_start_time", + "description": "Indicates the start of the time range for which to retrieve offline payments, in RFC 3339\nformat for timestamps. The range is determined using the\n`offline_payment_details.client_created_at` field for each Payment. If set, payments without a\nvalue set in `offline_payment_details.client_created_at` will not be returned.\n\nDefault: The current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range for which to retrieve offline payments, in RFC 3339\nformat for timestamps. The range is determined using the\n`offline_payment_details.client_created_at` field for each Payment. If set, payments without a\nvalue set in `offline_payment_details.client_created_at` will not be returned.\n\nDefault: The current time." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "offline_end_time", + "tool_parameter_name": "offline_payment_end_time", + "description": "Indicates the end of the time range for which to retrieve offline payments, in RFC 3339\nformat for timestamps. The range is determined using the\n`offline_payment_details.client_created_at` field for each Payment. If set, payments without a\nvalue set in `offline_payment_details.client_created_at` will not be returned.\n\nDefault: The current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range for which to retrieve offline payments, in RFC 3339\nformat for timestamps. The range is determined using the\n`offline_payment_details.client_created_at` field for each Payment. If set, payments without a\nvalue set in `offline_payment_details.client_created_at` will not be returned.\n\nDefault: The current time." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "updated_at_begin_time", + "tool_parameter_name": "updated_at_start_time", + "description": "Indicates the start of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `updated_at` field for each Payment.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `updated_at` field for each Payment." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "updated_at_end_time", + "tool_parameter_name": "end_time_for_update_retrieval", + "description": "Indicates the end of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `updated_at` field for each Payment.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve payments for, in RFC 3339 format. The\nrange is determined using the `updated_at` field for each Payment." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_field", + "tool_parameter_name": "sort_results_by_field", + "description": "The field used to sort results by. The default is `CREATED_AT`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "CREATED_AT", + "OFFLINE_CREATED_AT", + "UPDATED_AT" + ], + "properties": null, + "inner_properties": null, + "description": "The field used to sort results by. The default is `CREATED_AT`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchSpecificRefund.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchSpecificRefund.json new file mode 100644 index 00000000..2a8e3f0b --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/FetchSpecificRefund.json @@ -0,0 +1,105 @@ +{ + "name": "FetchSpecificRefund", + "fully_qualified_name": "SquareupApi.FetchSpecificRefund@0.1.0", + "description": "Retrieve details of a specific refund using its ID.\n\nCall this tool to fetch information about a particular refund by providing the refund ID. This is useful for checking the status and details of any refund made through the system.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "specific_refund_id", + "required": true, + "description": "The unique ID for the specific PaymentRefund to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `PaymentRefund`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "refund_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetPaymentRefund'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/refunds/{refund_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "refund_id", + "tool_parameter_name": "specific_refund_id", + "description": "The unique ID for the desired `PaymentRefund`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `PaymentRefund`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetAccountDisputes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetAccountDisputes.json new file mode 100644 index 00000000..c4dd66c8 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetAccountDisputes.json @@ -0,0 +1,187 @@ +{ + "name": "GetAccountDisputes", + "fully_qualified_name": "SquareupApi.GetAccountDisputes@0.1.0", + "description": "Fetches disputes associated with an account.\n\nUse this tool to retrieve all disputes linked to a specific account. This can help in tracking and managing any disputes that have arisen.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A cursor for retrieving the next set of dispute results from a previous query.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "dispute_states_filter", + "required": false, + "description": "Filter disputes by their states. Options include 'INQUIRY_EVIDENCE_REQUIRED', 'INQUIRY_PROCESSING', 'INQUIRY_CLOSED', 'EVIDENCE_REQUIRED', 'PROCESSING', 'WON', 'LOST', 'ACCEPTED'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "INQUIRY_EVIDENCE_REQUIRED", + "INQUIRY_PROCESSING", + "INQUIRY_CLOSED", + "EVIDENCE_REQUIRED", + "PROCESSING", + "WON", + "LOST", + "ACCEPTED" + ], + "properties": null, + "inner_properties": null, + "description": "The dispute states used to filter the result. If not specified, the endpoint returns all disputes." + }, + "inferrable": true, + "http_endpoint_parameter_name": "states" + }, + { + "name": "location_identifier", + "required": false, + "description": "The ID of the location to return a list of disputes for. If not provided, returns disputes for all locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to return a list of disputes.\nIf not specified, the endpoint returns disputes associated with all locations." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListDisputes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DISPUTES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/disputes", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "states", + "tool_parameter_name": "dispute_states_filter", + "description": "The dispute states used to filter the result. If not specified, the endpoint returns all disputes.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "INQUIRY_EVIDENCE_REQUIRED", + "INQUIRY_PROCESSING", + "INQUIRY_CLOSED", + "EVIDENCE_REQUIRED", + "PROCESSING", + "WON", + "LOST", + "ACCEPTED" + ], + "properties": null, + "inner_properties": null, + "description": "The dispute states used to filter the result. If not specified, the endpoint returns all disputes." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "location_identifier", + "description": "The ID of the location for which to return a list of disputes.\nIf not specified, the endpoint returns disputes associated with all locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to return a list of disputes.\nIf not specified, the endpoint returns disputes associated with all locations." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetails.json new file mode 100644 index 00000000..36fcb0e4 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetails.json @@ -0,0 +1,105 @@ +{ + "name": "GetBankAccountDetails", + "fully_qualified_name": "SquareupApi.GetBankAccountDetails@0.1.0", + "description": "Retrieve details of a Square account's bank account.\n\nFetches detailed information about a specific bank account linked to a Square account using the bank account ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "bank_account_identifier", + "required": true, + "description": "Square-issued ID of the specific bank account to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Square-issued ID of the desired `BankAccount`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "bank_account_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetBankAccount'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "BANK_ACCOUNTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bank-accounts/{bank_account_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "bank_account_id", + "tool_parameter_name": "bank_account_identifier", + "description": "Square-issued ID of the desired `BankAccount`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Square-issued ID of the desired `BankAccount`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetailsById.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetailsById.json new file mode 100644 index 00000000..bcd25e3d --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBankAccountDetailsById.json @@ -0,0 +1,105 @@ +{ + "name": "GetBankAccountDetailsById", + "fully_qualified_name": "SquareupApi.GetBankAccountDetailsById@0.1.0", + "description": "Retrieve bank account details using V1 ID.\n\nUse this tool to get detailed information about a bank account by providing the V1 bank account ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "v1_bank_account_id", + "required": true, + "description": "Connect V1 ID of the desired BankAccount. A unique string identifier to retrieve specific bank account details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Connect V1 ID of the desired `BankAccount`. For more information, see \n[Retrieve a bank account by using an ID issued by V1 Bank Accounts API](https://developer.squareup.com/docs/bank-accounts-api#retrieve-a-bank-account-by-using-an-id-issued-by-v1-bank-accounts-api)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "v1_bank_account_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetBankAccountByV1Id'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "BANK_ACCOUNTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bank-accounts/by-v1-id/{v1_bank_account_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "v1_bank_account_id", + "tool_parameter_name": "v1_bank_account_id", + "description": "Connect V1 ID of the desired `BankAccount`. For more information, see \n[Retrieve a bank account by using an ID issued by V1 Bank Accounts API](https://developer.squareup.com/docs/bank-accounts-api#retrieve-a-bank-account-by-using-an-id-issued-by-v1-bank-accounts-api).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Connect V1 ID of the desired `BankAccount`. For more information, see \n[Retrieve a bank account by using an ID issued by V1 Bank Accounts API](https://developer.squareup.com/docs/bank-accounts-api#retrieve-a-bank-account-by-using-an-id-issued-by-v1-bank-accounts-api)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttribute.json new file mode 100644 index 00000000..5163026c --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttribute.json @@ -0,0 +1,201 @@ +{ + "name": "GetBookingCustomAttribute", + "fully_qualified_name": "SquareupApi.GetBookingCustomAttribute@0.1.0", + "description": "Retrieve a custom attribute for a specific booking.\n\nUse this tool to get a custom attribute associated with a given booking, using either buyer- or seller-level permissions.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "target_booking_id", + "required": true, + "description": "The ID of the target booking to retrieve its custom attribute.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [booking](entity:Booking)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "booking_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute to retrieve, matching the custom attribute definition in the Square seller account. Use the qualified key if not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_version", + "required": false, + "description": "The current version of the custom attribute for consistent reads. An integer value required to ensure up-to-date data.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + }, + { + "name": "include_custom_attribute_definition", + "required": false, + "description": "Set to true to include the custom attribute's definition, such as name and data type, in the response. Defaults to false.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definition" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveBookingCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/{booking_id}/custom-attributes/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "with_definition", + "tool_parameter_name": "include_custom_attribute_definition", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "version", + "tool_parameter_name": "custom_attribute_version", + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "booking_id", + "tool_parameter_name": "target_booking_id", + "description": "The ID of the target [booking](entity:Booking).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [booking](entity:Booking)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttributes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttributes.json new file mode 100644 index 00000000..045c7e87 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingCustomAttributes.json @@ -0,0 +1,137 @@ +{ + "name": "GetBookingCustomAttributes", + "fully_qualified_name": "SquareupApi.GetBookingCustomAttributes@0.1.0", + "description": "Retrieve all custom attribute definitions for bookings.\n\nUse this tool to get all custom attribute definitions associated with bookings. It requires appropriate OAuth scopes for buyer or seller level permissions.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "maximum_results_per_page", + "required": false, + "description": "Advisory maximum results per page. Minimum is 1, maximum is 100, default is 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Cursor for retrieving the next page of results from a previous response.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListBookingCustomAttributeDefinitions'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/custom-attribute-definitions", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingList.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingList.json new file mode 100644 index 00000000..60f47476 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBookingList.json @@ -0,0 +1,297 @@ +{ + "name": "GetBookingList", + "fully_qualified_name": "SquareupApi.GetBookingList@0.1.0", + "description": "Retrieve a collection of bookings.\n\nUse this tool to get a collection of bookings from the Squareup service. Relevant permissions (OAuth scope) are needed: `APPOINTMENTS_READ` for buyer-level and `APPOINTMENTS_ALL_READ` along with `APPOINTMENTS_READ` for seller-level permissions.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "results_per_page_limit", + "required": false, + "description": "The maximum number of results to display per page in the response. Accepts an integer value.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results per page to return in a paged response." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The pagination cursor from the previous response for fetching the next page of results. Leave unset for the first page.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "specific_customer_id", + "required": false, + "description": "The specific customer for whom to retrieve bookings. If not set, retrieves bookings for all customers.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The [customer](entity:Customer) for whom to retrieve bookings. If this is not set, bookings for all customers are retrieved." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "team_member_id", + "required": false, + "description": "Specify the team member ID to retrieve bookings for. If not set, retrieves bookings for all team members.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The team member for whom to retrieve bookings. If this is not set, bookings of all members are retrieved." + }, + "inferrable": true, + "http_endpoint_parameter_name": "team_member_id" + }, + { + "name": "specific_location_id", + "required": false, + "description": "Specify the location ID to retrieve bookings for that location only. If not set, bookings for all locations are retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The location for which to retrieve bookings. If this is not set, all locations' bookings are retrieved." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "earliest_start_time", + "required": false, + "description": "The RFC 3339 timestamp for the earliest booking start time. Defaults to current time if not set.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The RFC 3339 timestamp specifying the earliest of the start time. If this is not set, the current time is used." + }, + "inferrable": true, + "http_endpoint_parameter_name": "start_at_min" + }, + { + "name": "latest_start_time", + "required": false, + "description": "The RFC 3339 timestamp for the latest acceptable start time of bookings. Defaults to 31 days after `start_at_min` if not set.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The RFC 3339 timestamp specifying the latest of the start time. If this is not set, the time of 31 days after `start_at_min` is used." + }, + "inferrable": true, + "http_endpoint_parameter_name": "start_at_max" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListBookings'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "limit", + "tool_parameter_name": "results_per_page_limit", + "description": "The maximum number of results per page to return in a paged response.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results per page to return in a paged response." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "customer_id", + "tool_parameter_name": "specific_customer_id", + "description": "The [customer](entity:Customer) for whom to retrieve bookings. If this is not set, bookings for all customers are retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The [customer](entity:Customer) for whom to retrieve bookings. If this is not set, bookings for all customers are retrieved." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "team_member_id", + "tool_parameter_name": "team_member_id", + "description": "The team member for whom to retrieve bookings. If this is not set, bookings of all members are retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The team member for whom to retrieve bookings. If this is not set, bookings of all members are retrieved." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "specific_location_id", + "description": "The location for which to retrieve bookings. If this is not set, all locations' bookings are retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The location for which to retrieve bookings. If this is not set, all locations' bookings are retrieved." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "start_at_min", + "tool_parameter_name": "earliest_start_time", + "description": "The RFC 3339 timestamp specifying the earliest of the start time. If this is not set, the current time is used.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The RFC 3339 timestamp specifying the earliest of the start time. If this is not set, the current time is used." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "start_at_max", + "tool_parameter_name": "latest_start_time", + "description": "The RFC 3339 timestamp specifying the latest of the start time. If this is not set, the time of 31 days after `start_at_min` is used.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The RFC 3339 timestamp specifying the latest of the start time. If this is not set, the time of 31 days after `start_at_min` is used." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBusinessBookingProfile.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBusinessBookingProfile.json new file mode 100644 index 00000000..976a1ad7 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetBusinessBookingProfile.json @@ -0,0 +1,71 @@ +{ + "name": "GetBusinessBookingProfile", + "fully_qualified_name": "SquareupApi.GetBusinessBookingProfile@0.1.0", + "description": "Retrieve seller's booking profile details.\n\nUse this tool to get detailed information about a seller's booking profile. Call this tool when you need to provide or display booking-related information for a seller.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveBusinessBookingProfile'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_BUSINESS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/business-booking-profile", + "http_method": "GET", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCashDrawerShiftDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCashDrawerShiftDetails.json new file mode 100644 index 00000000..e3ae0ad9 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCashDrawerShiftDetails.json @@ -0,0 +1,137 @@ +{ + "name": "GetCashDrawerShiftDetails", + "fully_qualified_name": "SquareupApi.GetCashDrawerShiftDetails@0.1.0", + "description": "Get summary details for a specific cash drawer shift.\n\nUse this tool to retrieve detailed information about a specific cash drawer shift, including relevant data about its transactions and status.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_identifier", + "required": true, + "description": "The unique identifier for the location to retrieve cash drawer shifts from. Ensure this matches the location set up in Squareup.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to retrieve cash drawer shifts from." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "cash_drawer_shift_id", + "required": true, + "description": "The unique identifier for the cash drawer shift to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The shift ID." + }, + "inferrable": true, + "http_endpoint_parameter_name": "shift_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCashDrawerShift'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CASH_DRAWER_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/cash-drawers/shifts/{shift_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_identifier", + "description": "The ID of the location to retrieve cash drawer shifts from.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to retrieve cash drawer shifts from." + }, + "accepted_as": "query", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "shift_id", + "tool_parameter_name": "cash_drawer_shift_id", + "description": "The shift ID.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The shift ID." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerCustomAttributeDefinition.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerCustomAttributeDefinition.json new file mode 100644 index 00000000..51dca113 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerCustomAttributeDefinition.json @@ -0,0 +1,137 @@ +{ + "name": "GetCustomerCustomAttributeDefinition", + "fully_qualified_name": "SquareupApi.GetCustomerCustomAttributeDefinition@0.1.0", + "description": "Retrieve a customer's custom attribute definition from Square.\n\nFetches a customer-related custom attribute definition from a Square seller account. This should be called to get definitions where visibility is either 'READ_ONLY' or 'READ_WRITE_VALUES', including seller-defined custom fields.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute definition to retrieve. Use the qualified key if not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_version", + "required": false, + "description": "Current version of the attribute definition for consistent reads. Returns specified or higher version data. Error if version is too high.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCustomerCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/custom-attribute-definitions/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "custom_attribute_version", + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerDetails.json new file mode 100644 index 00000000..dcead9fd --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetCustomerDetails.json @@ -0,0 +1,105 @@ +{ + "name": "GetCustomerDetails", + "fully_qualified_name": "SquareupApi.GetCustomerDetails@0.1.0", + "description": "Retrieve details for a specific customer.\n\nUse this tool to get detailed information about a specific customer by their ID. Ideal for when you need to access customer profiles or verify customer details.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_id", + "required": true, + "description": "The unique ID of the customer to retrieve details for. Used to access specific customer information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCustomer'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/{customer_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "customer_id", + "tool_parameter_name": "customer_id", + "description": "The ID of the customer to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetDisputeEvidenceMetadata.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetDisputeEvidenceMetadata.json new file mode 100644 index 00000000..94c64b32 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetDisputeEvidenceMetadata.json @@ -0,0 +1,137 @@ +{ + "name": "GetDisputeEvidenceMetadata", + "fully_qualified_name": "SquareupApi.GetDisputeEvidenceMetadata@0.1.0", + "description": "Retrieve metadata for specified dispute evidence.\n\nCall this tool to obtain metadata of dispute evidence using a given dispute ID and evidence ID. Ensure to maintain a copy of any evidence uploaded as it cannot be downloaded later.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "dispute_id", + "required": true, + "description": "The unique ID of the dispute to retrieve its evidence metadata.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute from which you want to retrieve evidence metadata." + }, + "inferrable": true, + "http_endpoint_parameter_name": "dispute_id" + }, + { + "name": "evidence_id", + "required": true, + "description": "The ID of the evidence you wish to retrieve metadata for. Ensure correct ID is provided to access the specific evidence details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the evidence to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "evidence_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveDisputeEvidence'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DISPUTES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/disputes/{dispute_id}/evidence/{evidence_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "dispute_id", + "tool_parameter_name": "dispute_id", + "description": "The ID of the dispute from which you want to retrieve evidence metadata.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute from which you want to retrieve evidence metadata." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "evidence_id", + "tool_parameter_name": "evidence_id", + "description": "The ID of the evidence to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the evidence to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetGiftCardDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetGiftCardDetails.json new file mode 100644 index 00000000..52f32164 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetGiftCardDetails.json @@ -0,0 +1,105 @@ +{ + "name": "GetGiftCardDetails", + "fully_qualified_name": "SquareupApi.GetGiftCardDetails@0.1.0", + "description": "Retrieve details of a gift card using its ID.\n\nUse this tool to access information about a specific gift card by providing its ID. It is useful for checking gift card balance, status, and other related details.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "gift_card_id", + "required": true, + "description": "The ID of the gift card to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the gift card to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveGiftCard'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "GIFTCARDS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/gift-cards/{id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "gift_card_id", + "description": "The ID of the gift card to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the gift card to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryAdjustment.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryAdjustment.json new file mode 100644 index 00000000..0872ab08 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryAdjustment.json @@ -0,0 +1,105 @@ +{ + "name": "GetInventoryAdjustment", + "fully_qualified_name": "SquareupApi.GetInventoryAdjustment@0.1.0", + "description": "Retrieve detailed information on an inventory adjustment.\n\nThis tool retrieves the details of a specific InventoryAdjustment using the provided adjustment ID. It should be called when you need to obtain information about changes in inventory quantities.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "inventory_adjustment_id", + "required": true, + "description": "The unique ID of the inventory adjustment to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [InventoryAdjustment](entity:InventoryAdjustment) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "adjustment_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveInventoryAdjustment'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "INVENTORY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/inventory/adjustments/{adjustment_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "adjustment_id", + "tool_parameter_name": "inventory_adjustment_id", + "description": "ID of the [InventoryAdjustment](entity:InventoryAdjustment) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [InventoryAdjustment](entity:InventoryAdjustment) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryTransfer.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryTransfer.json new file mode 100644 index 00000000..27c4a684 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetInventoryTransfer.json @@ -0,0 +1,105 @@ +{ + "name": "GetInventoryTransfer", + "fully_qualified_name": "SquareupApi.GetInventoryTransfer@0.1.0", + "description": "Retrieve details of an Inventory Transfer using its ID.\n\nUse this tool to obtain information about a specific Inventory Transfer by providing its transfer ID. This can be useful for tracking inventory movements within a system.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "inventory_transfer_id", + "required": true, + "description": "The unique ID of the InventoryTransfer to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [InventoryTransfer](entity:InventoryTransfer) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "transfer_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveInventoryTransfer'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "INVENTORY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/inventory/transfers/{transfer_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "transfer_id", + "tool_parameter_name": "inventory_transfer_id", + "description": "ID of the [InventoryTransfer](entity:InventoryTransfer) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [InventoryTransfer](entity:InventoryTransfer) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetLocationCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetLocationCustomAttribute.json new file mode 100644 index 00000000..8cf47ed3 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetLocationCustomAttribute.json @@ -0,0 +1,201 @@ +{ + "name": "GetLocationCustomAttribute", + "fully_qualified_name": "SquareupApi.GetLocationCustomAttribute@0.1.0", + "description": "Retrieve a custom attribute for a specified location.\n\nThis tool fetches a custom attribute associated with a specific location. Optional retrieval of the custom attribute's definition is available. Visibility settings must permit access if owned by another application.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": true, + "description": "The ID of the location for which the custom attribute is being retrieved. This is required to identify the specific location in the Square account.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [location](entity:Location)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute to retrieve. Must match a custom attribute definition key in the Square seller account. Use the qualified key if not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_version", + "required": false, + "description": "Specify the version of the custom attribute for consistent reads. If a higher version exists, it is returned. If higher than the current version, an error occurs.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + }, + { + "name": "include_definition", + "required": false, + "description": "Set to true to include the custom attribute's definition, providing name, description, and data type.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definition" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLocationCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations/{location_id}/custom-attributes/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "with_definition", + "tool_parameter_name": "include_definition", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "version", + "tool_parameter_name": "custom_attribute_version", + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the target [location](entity:Location).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [location](entity:Location)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantCustomAttribute.json new file mode 100644 index 00000000..54fb84a7 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantCustomAttribute.json @@ -0,0 +1,201 @@ +{ + "name": "GetMerchantCustomAttribute", + "fully_qualified_name": "SquareupApi.GetMerchantCustomAttribute@0.1.0", + "description": "Retrieve a custom attribute for a specific merchant.\n\nThis tool retrieves a custom attribute associated with a merchant. Use it to access merchant-specific data, with the option to include the custom attribute definition. Visibility settings dictate access permissions.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "merchant_id", + "required": true, + "description": "The unique identifier for the target merchant whose custom attribute is to be retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [merchant](entity:Merchant)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "merchant_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute to retrieve. Must match the `key` of a custom attribute definition in the Square seller account.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_version", + "required": false, + "description": "Specifies the version of the custom attribute for consistent reads. If higher than current, returns an error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + }, + { + "name": "include_definition", + "required": false, + "description": "Set to true to include the custom attribute definition, providing additional details such as name, description, and data type.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definition" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveMerchantCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants/{merchant_id}/custom-attributes/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "with_definition", + "tool_parameter_name": "include_definition", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "version", + "tool_parameter_name": "custom_attribute_version", + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "merchant_id", + "tool_parameter_name": "merchant_id", + "description": "The ID of the target [merchant](entity:Merchant).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [merchant](entity:Merchant)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantDetails.json new file mode 100644 index 00000000..4cca5ea7 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetMerchantDetails.json @@ -0,0 +1,105 @@ +{ + "name": "GetMerchantDetails", + "fully_qualified_name": "SquareupApi.GetMerchantDetails@0.1.0", + "description": "Retrieve merchant details using an access token.\n\nProvides information about the merchant linked to the specified access token. Typically returns a single merchant object. Useful for obtaining merchant details for personal or OAuth token-based access.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "previous_response_cursor", + "required": false, + "description": "The cursor generated by the previous response. Use this to fetch the next set of merchant details if needed.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor generated by the previous response." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListMerchants'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "previous_response_cursor", + "description": "The cursor generated by the previous response.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor generated by the previous response." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPaymentDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPaymentDetails.json new file mode 100644 index 00000000..3e370db4 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPaymentDetails.json @@ -0,0 +1,105 @@ +{ + "name": "GetPaymentDetails", + "fully_qualified_name": "SquareupApi.GetPaymentDetails@0.1.0", + "description": "Retrieve specific payment details by payment ID.\n\nUse this tool to obtain detailed information about a specific payment using its payment ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "payment_id", + "required": true, + "description": "A unique ID for the desired payment to retrieve specific payment details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A unique ID for the desired payment." + }, + "inferrable": true, + "http_endpoint_parameter_name": "payment_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetPayment'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/payments/{payment_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "payment_id", + "tool_parameter_name": "payment_id", + "description": "A unique ID for the desired payment.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A unique ID for the desired payment." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutDetails.json new file mode 100644 index 00000000..e55eb93b --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutDetails.json @@ -0,0 +1,101 @@ +{ + "name": "GetPayoutDetails", + "fully_qualified_name": "SquareupApi.GetPayoutDetails@0.1.0", + "description": "Retrieve details of a specific payout by payout ID.\n\nUse this tool to get detailed information about a specific payout by providing the payout ID. Useful for tracking or reviewing specific payout transactions.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "payout_id", + "required": true, + "description": "The unique identifier of the payout to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payout to retrieve the information for." + }, + "inferrable": true, + "http_endpoint_parameter_name": "payout_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetPayout'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/payouts/{payout_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "payout_id", + "tool_parameter_name": "payout_id", + "description": "The ID of the payout to retrieve the information for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payout to retrieve the information for." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutList.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutList.json new file mode 100644 index 00000000..cd81eb19 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetPayoutList.json @@ -0,0 +1,307 @@ +{ + "name": "GetPayoutList", + "fully_qualified_name": "SquareupApi.GetPayoutList@0.1.0", + "description": "Retrieve a list of all payouts for the default location.\n\nThis tool retrieves all payouts for the default location, allowing filtration by location ID, status, time range, and sorting order. It requires the `PAYOUTS_READ` OAuth scope.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": false, + "description": "ID of the location to list payouts. Defaults to the main location if not specified.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to list the payouts.\nBy default, payouts are returned for the default (main) location associated with the seller." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "payout_status_filter", + "required": false, + "description": "Filter payouts by status: 'SENT', 'FAILED', or 'PAID'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "SENT", + "FAILED", + "PAID" + ], + "properties": null, + "inner_properties": null, + "description": "If provided, only payouts with the given status are returned." + }, + "inferrable": true, + "http_endpoint_parameter_name": "status" + }, + { + "name": "start_time_for_payouts", + "required": false, + "description": "RFC 3339 formatted timestamp for the beginning of payout creation. Defaults to one year ago.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the beginning of the payout creation time, in RFC 3339 format.\nInclusive. Default: The current time minus one year." + }, + "inferrable": true, + "http_endpoint_parameter_name": "begin_time" + }, + { + "name": "end_time", + "required": false, + "description": "The timestamp for the end of the payout creation time, in RFC 3339 format. Defaults to the current time if not provided.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the end of the payout creation time, in RFC 3339 format.\nDefault: The current time." + }, + "inferrable": true, + "http_endpoint_parameter_name": "end_time" + }, + { + "name": "sort_order", + "required": false, + "description": "Determines if the list of payouts is sorted in ascending ('ASC') or descending ('DESC') order.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which payouts are listed." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor from a previous call, used to retrieve the next set of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).\nIf request parameters change between requests, subsequent results may contain duplicates or missing records." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "The maximum number of results to return per page. Must be 100 or fewer; defaults to 100 if a higher value is provided.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value. If the provided value is\ngreater than 100, it is ignored and the default value is used instead.\nDefault: `100`" + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListPayouts'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/payouts", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the location for which to list the payouts.\nBy default, payouts are returned for the default (main) location associated with the seller.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to list the payouts.\nBy default, payouts are returned for the default (main) location associated with the seller." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "status", + "tool_parameter_name": "payout_status_filter", + "description": "If provided, only payouts with the given status are returned.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "SENT", + "FAILED", + "PAID" + ], + "properties": null, + "inner_properties": null, + "description": "If provided, only payouts with the given status are returned." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "begin_time", + "tool_parameter_name": "start_time_for_payouts", + "description": "The timestamp for the beginning of the payout creation time, in RFC 3339 format.\nInclusive. Default: The current time minus one year.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the beginning of the payout creation time, in RFC 3339 format.\nInclusive. Default: The current time minus one year." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "end_time", + "tool_parameter_name": "end_time", + "description": "The timestamp for the end of the payout creation time, in RFC 3339 format.\nDefault: The current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the end of the payout creation time, in RFC 3339 format.\nDefault: The current time." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "sort_order", + "description": "The order in which payouts are listed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which payouts are listed." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).\nIf request parameters change between requests, subsequent results may contain duplicates or missing records.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).\nIf request parameters change between requests, subsequent results may contain duplicates or missing records." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value. If the provided value is\ngreater than 100, it is ignored and the default value is used instead.\nDefault: `100`", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value. If the provided value is\ngreater than 100, it is ignored and the default value is used instead.\nDefault: `100`" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetScheduledShift.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetScheduledShift.json new file mode 100644 index 00000000..d8449bce --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetScheduledShift.json @@ -0,0 +1,105 @@ +{ + "name": "GetScheduledShift", + "fully_qualified_name": "SquareupApi.GetScheduledShift@0.1.0", + "description": "Retrieve details of a scheduled shift by ID.\n\nThe tool retrieves information about a scheduled shift using its unique ID. Call this tool when you need detailed information about a specific shift.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "scheduled_shift_id", + "required": true, + "description": "The unique ID of the scheduled shift to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the scheduled shift to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveScheduledShift'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "TIMECARDS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/scheduled-shifts/{id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "scheduled_shift_id", + "description": "The ID of the scheduled shift to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the scheduled shift to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetSquareMerchantSettings.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetSquareMerchantSettings.json new file mode 100644 index 00000000..4a2bf769 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetSquareMerchantSettings.json @@ -0,0 +1,72 @@ +{ + "name": "GetSquareMerchantSettings", + "fully_qualified_name": "SquareupApi.GetSquareMerchantSettings@0.1.0", + "description": "Retrieve merchant settings for Square checkout pages.\n\nUse this tool to get the merchant-level settings configured for a Square-hosted checkout page. Useful for accessing checkout configurations and preferences.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveMerchantSettings'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ", + "PAYMENT_METHODS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/online-checkout/merchant-settings", + "http_method": "GET", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTeamMemberWage.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTeamMemberWage.json new file mode 100644 index 00000000..036761f2 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTeamMemberWage.json @@ -0,0 +1,105 @@ +{ + "name": "GetTeamMemberWage", + "fully_qualified_name": "SquareupApi.GetTeamMemberWage@0.1.0", + "description": "Retrieve wage details for a specified team member.\n\nUse this tool to obtain wage information for a specific team member by providing their unique ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "team_member_wage_id", + "required": true, + "description": "The unique UUID for retrieving the specified team member's wage.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `TeamMemberWage` being retrieved." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetTeamMemberWage'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "EMPLOYEES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/team-member-wages/{id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "team_member_wage_id", + "description": "The UUID for the `TeamMemberWage` being retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `TeamMemberWage` being retrieved." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalAction.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalAction.json new file mode 100644 index 00000000..abcca5ef --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalAction.json @@ -0,0 +1,105 @@ +{ + "name": "GetTerminalAction", + "fully_qualified_name": "SquareupApi.GetTerminalAction@0.1.0", + "description": "Retrieve details of a terminal action request by ID.\n\nThis tool retrieves a Terminal action request using the specified `action_id`. Terminal action requests can be accessed within 30 days of their request.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_action_id", + "required": true, + "description": "Unique ID of the terminal action to retrieve. Must be provided to access the TerminalAction details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired `TerminalAction`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "action_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetTerminalAction'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/actions/{action_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "action_id", + "tool_parameter_name": "terminal_action_id", + "description": "Unique ID for the desired `TerminalAction`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired `TerminalAction`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalRefund.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalRefund.json new file mode 100644 index 00000000..d65c2457 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/GetTerminalRefund.json @@ -0,0 +1,105 @@ +{ + "name": "GetTerminalRefund", + "fully_qualified_name": "SquareupApi.GetTerminalRefund@0.1.0", + "description": "Fetch Interac Terminal refund details by ID.\n\nUse this tool to retrieve details of an Interac Terminal refund within 30 days of its creation using the refund ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_refund_id", + "required": true, + "description": "The unique ID of the Interac Terminal refund to retrieve. Must be used within 30 days of creation.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalRefund`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "terminal_refund_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetTerminalRefund'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/refunds/{terminal_refund_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "terminal_refund_id", + "tool_parameter_name": "terminal_refund_id", + "description": "The unique ID for the desired `TerminalRefund`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalRefund`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBankAccounts.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBankAccounts.json new file mode 100644 index 00000000..fc38e4ca --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBankAccounts.json @@ -0,0 +1,169 @@ +{ + "name": "ListBankAccounts", + "fully_qualified_name": "SquareupApi.ListBankAccounts@0.1.0", + "description": "Fetch a list of bank accounts linked to a Square account.\n\nCall this tool to retrieve all bank accounts associated with a Square account. Useful for checking account details or managing linked bank accounts.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "The pagination cursor from a previous call to fetch the next set of bank account results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor returned by a previous call to this endpoint.\nUse it in the next `ListBankAccounts` request to retrieve the next set \nof results.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "max_bank_accounts_limit", + "required": false, + "description": "Specify the maximum number of bank accounts to return. The largest supported limit is 1000.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Upper limit on the number of bank accounts to return in the response. \nCurrently, 1000 is the largest supported limit. You can specify a limit \nof up to 1000 bank accounts. This is also the default limit." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "location_id_filter", + "required": false, + "description": "Optional filter to retrieve bank accounts for a specified location ID only.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Location ID. You can specify this optional filter \nto retrieve only the linked bank accounts belonging to a specific location." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListBankAccounts'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "BANK_ACCOUNTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bank-accounts", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The pagination cursor returned by a previous call to this endpoint.\nUse it in the next `ListBankAccounts` request to retrieve the next set \nof results.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor returned by a previous call to this endpoint.\nUse it in the next `ListBankAccounts` request to retrieve the next set \nof results.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_bank_accounts_limit", + "description": "Upper limit on the number of bank accounts to return in the response. \nCurrently, 1000 is the largest supported limit. You can specify a limit \nof up to 1000 bank accounts. This is also the default limit.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Upper limit on the number of bank accounts to return in the response. \nCurrently, 1000 is the largest supported limit. You can specify a limit \nof up to 1000 bank accounts. This is also the default limit." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "location_id_filter", + "description": "Location ID. You can specify this optional filter \nto retrieve only the linked bank accounts belonging to a specific location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Location ID. You can specify this optional filter \nto retrieve only the linked bank accounts belonging to a specific location." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBookingCustomAttributes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBookingCustomAttributes.json new file mode 100644 index 00000000..0904b8d7 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBookingCustomAttributes.json @@ -0,0 +1,201 @@ +{ + "name": "ListBookingCustomAttributes", + "fully_qualified_name": "SquareupApi.ListBookingCustomAttributes@0.1.0", + "description": "Lists custom attributes for a specific booking.\n\nUse this tool to retrieve the custom attributes associated with a specific booking. Ensure the appropriate OAuth permissions (`APPOINTMENTS_READ` for buyer-level or `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for seller-level) are set before calling this endpoint.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "booking_identifier", + "required": true, + "description": "The unique identifier for the target booking whose custom attributes you want to list.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [booking](entity:Booking)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "booking_id" + }, + { + "name": "maximum_results_per_page", + "required": false, + "description": "The maximum number of results to return per page, between 1 and 100. Default is 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Cursor for retrieving the next page of results from a previous call to the endpoint.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "include_custom_attribute_definitions", + "required": false, + "description": "Set to true to include custom attribute definition details, such as name and data type, in the response. Default is false.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definitions" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListBookingCustomAttributes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/{booking_id}/custom-attributes", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "with_definitions", + "tool_parameter_name": "include_custom_attribute_definitions", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "booking_id", + "tool_parameter_name": "booking_identifier", + "description": "The ID of the target [booking](entity:Booking).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [booking](entity:Booking)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBusinessBreakTypes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBusinessBreakTypes.json new file mode 100644 index 00000000..957691b8 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListBusinessBreakTypes.json @@ -0,0 +1,169 @@ +{ + "name": "ListBusinessBreakTypes", + "fully_qualified_name": "SquareupApi.ListBusinessBreakTypes@0.1.0", + "description": "Retrieve a list of BreakType instances for a business.\n\nThis tool provides a paginated list of BreakType instances associated with a business. Use it to fetch information about different break types configured in a business's system.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "filter_by_location_id", + "required": false, + "description": "Filter results to only include BreakTypes associated with a specific location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Filter the returned `BreakType` results to only those that are associated with the\nspecified location." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "The maximum number of BreakType results to return per page, between 1 and 200. Default is 200.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of `BreakType` results to return per page. The number can range between 1\nand 200. The default is 200." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A pointer to the next page of BreakType results for retrieval.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pointer to the next page of `BreakType` results to fetch." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListBreakTypes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "TIMECARDS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/break-types", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "filter_by_location_id", + "description": "Filter the returned `BreakType` results to only those that are associated with the\nspecified location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Filter the returned `BreakType` results to only those that are associated with the\nspecified location." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of `BreakType` results to return per page. The number can range between 1\nand 200. The default is 200.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of `BreakType` results to return per page. The number can range between 1\nand 200. The default is 200." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pointer to the next page of `BreakType` results to fetch.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pointer to the next page of `BreakType` results to fetch." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShiftEvents.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShiftEvents.json new file mode 100644 index 00000000..0af41c51 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShiftEvents.json @@ -0,0 +1,201 @@ +{ + "name": "ListCashDrawerShiftEvents", + "fully_qualified_name": "SquareupApi.ListCashDrawerShiftEvents@0.1.0", + "description": "Retrieve events for a specific cash drawer shift.\n\nThis tool retrieves a paginated list of events for a specific cash drawer shift. It is useful for tracking activities and occurrences related to a particular shift.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_identifier", + "required": true, + "description": "The ID of the location to list cash drawer shifts for. This should be a valid location ID registered within the system.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to list cash drawer shifts for." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "cash_drawer_shift_id", + "required": true, + "description": "The unique ID of the cash drawer shift for which events are to be retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The shift ID." + }, + "inferrable": true, + "http_endpoint_parameter_name": "shift_id" + }, + { + "name": "page_size_limit", + "required": false, + "description": "Number of events to return per page, default is 200, maximum is 1000.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Number of resources to be returned in a page of results (200 by\ndefault, 1000 max)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Opaque string to fetch the next page of results for cash drawer shift events.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Opaque cursor for fetching the next page of results." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCashDrawerShiftEvents'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CASH_DRAWER_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/cash-drawers/shifts/{shift_id}/events", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_identifier", + "description": "The ID of the location to list cash drawer shifts for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to list cash drawer shifts for." + }, + "accepted_as": "query", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "page_size_limit", + "description": "Number of resources to be returned in a page of results (200 by\ndefault, 1000 max).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Number of resources to be returned in a page of results (200 by\ndefault, 1000 max)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "Opaque cursor for fetching the next page of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Opaque cursor for fetching the next page of results." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "shift_id", + "tool_parameter_name": "cash_drawer_shift_id", + "description": "The shift ID.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The shift ID." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShifts.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShifts.json new file mode 100644 index 00000000..f81c5dfb --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCashDrawerShifts.json @@ -0,0 +1,271 @@ +{ + "name": "ListCashDrawerShifts", + "fully_qualified_name": "SquareupApi.ListCashDrawerShifts@0.1.0", + "description": "Retrieve cash drawer shift details for a location and date range.\n\nThis tool provides details for all the cash drawer shifts for a specified location within a given date range. It should be called when cash drawer shift information is needed, such as start and end times, cash amounts, or other shift details for financial tracking and auditing purposes.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_identifier", + "required": true, + "description": "The unique identifier for the location to query for cash drawer shifts.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to query for a list of cash drawer shifts." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "sort_order_for_listing", + "required": false, + "description": "Specifies the order for listing cash drawer shifts by their opened_at field. Use 'ASC' for ascending or 'DESC' for descending. Defaults to 'ASC'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which cash drawer shifts are listed in the response,\nbased on their opened_at field. Default value: ASC" + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "query_start_time", + "required": false, + "description": "The inclusive start time for the query on opened_at, in ISO 8601 format.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The inclusive start time of the query on opened_at, in ISO 8601 format." + }, + "inferrable": true, + "http_endpoint_parameter_name": "begin_time" + }, + { + "name": "exclusive_end_date", + "required": false, + "description": "The exclusive end time of the query on opened_at, specified in ISO 8601 format, to define the endpoint for the cash drawer shift search.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The exclusive end date of the query on opened_at, in ISO 8601 format." + }, + "inferrable": true, + "http_endpoint_parameter_name": "end_time" + }, + { + "name": "result_limit", + "required": false, + "description": "Specifies the number of cash drawer shift events per results page. Defaults to 200, with a maximum of 1000.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Number of cash drawer shift events in a page of results (200 by\ndefault, 1000 max)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "next_page_cursor", + "required": false, + "description": "Opaque cursor for fetching the next page of results, used for pagination.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Opaque cursor for fetching the next page of results." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCashDrawerShifts'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CASH_DRAWER_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/cash-drawers/shifts", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_identifier", + "description": "The ID of the location to query for a list of cash drawer shifts.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to query for a list of cash drawer shifts." + }, + "accepted_as": "query", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "sort_order_for_listing", + "description": "The order in which cash drawer shifts are listed in the response,\nbased on their opened_at field. Default value: ASC", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which cash drawer shifts are listed in the response,\nbased on their opened_at field. Default value: ASC" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "begin_time", + "tool_parameter_name": "query_start_time", + "description": "The inclusive start time of the query on opened_at, in ISO 8601 format.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The inclusive start time of the query on opened_at, in ISO 8601 format." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "end_time", + "tool_parameter_name": "exclusive_end_date", + "description": "The exclusive end date of the query on opened_at, in ISO 8601 format.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The exclusive end date of the query on opened_at, in ISO 8601 format." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "result_limit", + "description": "Number of cash drawer shift events in a page of results (200 by\ndefault, 1000 max).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Number of cash drawer shift events in a page of results (200 by\ndefault, 1000 max)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "next_page_cursor", + "description": "Opaque cursor for fetching the next page of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Opaque cursor for fetching the next page of results." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCatalogItems.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCatalogItems.json new file mode 100644 index 00000000..a8a353b6 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCatalogItems.json @@ -0,0 +1,169 @@ +{ + "name": "ListCatalogItems", + "fully_qualified_name": "SquareupApi.ListCatalogItems@0.1.0", + "description": "Retrieve a list of catalog objects by type.\n\nThis tool retrieves a list of all catalog objects of specified types, such as ITEM, ITEM_VARIATION, MODIFIER, etc., excluding deleted items. It's useful for accessing and managing various components of a catalog in the Square ecosystem.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "The pagination cursor from the previous response. Leave empty for the initial request. Defaults to a page size of 100 results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor returned in the previous response. Leave unset for an initial request.\nThe page size is currently set to be 100.\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "catalog_object_types", + "required": false, + "description": "A comma-separated list of catalog object types to retrieve. Defaults to returning top-level types if unspecified.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "An optional case-insensitive, comma-separated list of object types to retrieve.\n\nThe valid values are defined in the [CatalogObjectType](entity:CatalogObjectType) enum, for example,\n`ITEM`, `ITEM_VARIATION`, `CATEGORY`, `DISCOUNT`, `TAX`,\n`MODIFIER`, `MODIFIER_LIST`, `IMAGE`, etc.\n\nIf this is unspecified, the operation returns objects of all the top level types at the version\nof the Square API used to make the request. Object types that are nested onto other object types\nare not included in the defaults.\n\nAt the current API version the default object types are:\nITEM, CATEGORY, TAX, DISCOUNT, MODIFIER_LIST, \nPRICING_RULE, PRODUCT_SET, TIME_PERIOD, MEASUREMENT_UNIT,\nSUBSCRIPTION_PLAN, ITEM_OPTION, CUSTOM_ATTRIBUTE_DEFINITION, QUICK_AMOUNT_SETTINGS." + }, + "inferrable": true, + "http_endpoint_parameter_name": "types" + }, + { + "name": "catalog_version", + "required": false, + "description": "Specify the version of the catalog objects to retrieve. Use to access historical versions. Default retrieves the current version.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The specific version of the catalog objects to be included in the response.\nThis allows you to retrieve historical versions of objects. The specified version value is matched against\nthe [CatalogObject](entity:CatalogObject)s' `version` attribute. If not included, results will be from the\ncurrent version of the catalog." + }, + "inferrable": true, + "http_endpoint_parameter_name": "catalog_version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCatalog'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ITEMS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/catalog/list", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The pagination cursor returned in the previous response. Leave unset for an initial request.\nThe page size is currently set to be 100.\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor returned in the previous response. Leave unset for an initial request.\nThe page size is currently set to be 100.\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "types", + "tool_parameter_name": "catalog_object_types", + "description": "An optional case-insensitive, comma-separated list of object types to retrieve.\n\nThe valid values are defined in the [CatalogObjectType](entity:CatalogObjectType) enum, for example,\n`ITEM`, `ITEM_VARIATION`, `CATEGORY`, `DISCOUNT`, `TAX`,\n`MODIFIER`, `MODIFIER_LIST`, `IMAGE`, etc.\n\nIf this is unspecified, the operation returns objects of all the top level types at the version\nof the Square API used to make the request. Object types that are nested onto other object types\nare not included in the defaults.\n\nAt the current API version the default object types are:\nITEM, CATEGORY, TAX, DISCOUNT, MODIFIER_LIST, \nPRICING_RULE, PRODUCT_SET, TIME_PERIOD, MEASUREMENT_UNIT,\nSUBSCRIPTION_PLAN, ITEM_OPTION, CUSTOM_ATTRIBUTE_DEFINITION, QUICK_AMOUNT_SETTINGS.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "An optional case-insensitive, comma-separated list of object types to retrieve.\n\nThe valid values are defined in the [CatalogObjectType](entity:CatalogObjectType) enum, for example,\n`ITEM`, `ITEM_VARIATION`, `CATEGORY`, `DISCOUNT`, `TAX`,\n`MODIFIER`, `MODIFIER_LIST`, `IMAGE`, etc.\n\nIf this is unspecified, the operation returns objects of all the top level types at the version\nof the Square API used to make the request. Object types that are nested onto other object types\nare not included in the defaults.\n\nAt the current API version the default object types are:\nITEM, CATEGORY, TAX, DISCOUNT, MODIFIER_LIST, \nPRICING_RULE, PRODUCT_SET, TIME_PERIOD, MEASUREMENT_UNIT,\nSUBSCRIPTION_PLAN, ITEM_OPTION, CUSTOM_ATTRIBUTE_DEFINITION, QUICK_AMOUNT_SETTINGS." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "catalog_version", + "tool_parameter_name": "catalog_version", + "description": "The specific version of the catalog objects to be included in the response.\nThis allows you to retrieve historical versions of objects. The specified version value is matched against\nthe [CatalogObject](entity:CatalogObject)s' `version` attribute. If not included, results will be from the\ncurrent version of the catalog.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The specific version of the catalog objects to be included in the response.\nThis allows you to retrieve historical versions of objects. The specified version value is matched against\nthe [CatalogObject](entity:CatalogObject)s' `version` attribute. If not included, results will be from the\ncurrent version of the catalog." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributeDefinitions.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributeDefinitions.json new file mode 100644 index 00000000..39dfa392 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributeDefinitions.json @@ -0,0 +1,137 @@ +{ + "name": "ListCustomerCustomAttributeDefinitions", + "fully_qualified_name": "SquareupApi.ListCustomerCustomAttributeDefinitions@0.1.0", + "description": "Retrieve customer custom attribute definitions for a Square seller.\n\nUse this tool to list all customer-related custom attribute definitions for a Square seller account. It returns all visible custom attribute definitions to the requesting application, including those set by other applications.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "maximum_results_per_page", + "required": false, + "description": "The maximum number of results to return in a paged response. Accepts values from 1 to 100, with a default of 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Cursor for retrieving the next page of results. Obtain this from a previous response.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCustomerCustomAttributeDefinitions'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/custom-attribute-definitions", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributes.json new file mode 100644 index 00000000..c1a2bc21 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerCustomAttributes.json @@ -0,0 +1,201 @@ +{ + "name": "ListCustomerCustomAttributes", + "fully_qualified_name": "SquareupApi.ListCustomerCustomAttributes@0.1.0", + "description": "Retrieve custom attributes for a customer profile.\n\nThis tool lists the custom attributes associated with a specified customer profile. It can also retrieve custom attribute definitions if specified. It returns all attributes visible to the requesting application, including those with read-only or read-write visibility owned by other applications.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_profile_id", + "required": true, + "description": "The ID of the customer profile for which to list custom attributes.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [customer profile](entity:Customer)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "result_limit", + "required": false, + "description": "Maximum number of results for a single response. Accepts values 1-100, with a default of 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The pagination cursor from the previous response to continue retrieving results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "include_custom_attribute_definitions", + "required": false, + "description": "Indicate whether to include custom attribute definitions such as name, description, and data type details in the response. Default is false.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definitions" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCustomerCustomAttributes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/{customer_id}/custom-attributes", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "limit", + "tool_parameter_name": "result_limit", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "with_definitions", + "tool_parameter_name": "include_custom_attribute_definitions", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "customer_id", + "tool_parameter_name": "customer_profile_id", + "description": "The ID of the target [customer profile](entity:Customer).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [customer profile](entity:Customer)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerGroups.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerGroups.json new file mode 100644 index 00000000..c58ef8e6 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerGroups.json @@ -0,0 +1,137 @@ +{ + "name": "ListCustomerGroups", + "fully_qualified_name": "SquareupApi.ListCustomerGroups@0.1.0", + "description": "Retrieve the list of customer groups for a business.\n\nUse this tool to access all customer groups associated with a business. Useful for managing or displaying customer segmentation and categories.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor to retrieve the next set of customer groups. Used to continue from the last retrieved page.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "maximum_results_per_page", + "required": false, + "description": "The maximum number of results to return per page, between 1 and 50. Defaults to 50.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the limit is less than 1 or greater than 50, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 50.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCustomerGroups'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/groups", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the limit is less than 1 or greater than 50, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 50.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the limit is less than 1 or greater than 50, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 50.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerSegments.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerSegments.json new file mode 100644 index 00000000..a0b421aa --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListCustomerSegments.json @@ -0,0 +1,137 @@ +{ + "name": "ListCustomerSegments", + "fully_qualified_name": "SquareupApi.ListCustomerSegments@0.1.0", + "description": "Retrieve the list of customer segments for a business.\n\nCall this tool to obtain the customer segments associated with a business. This can be useful for understanding customer classifications and targeting specific groups in marketing or service strategies.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor for retrieving the next set of customer segment results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by previous calls to `ListCustomerSegments`.\nThis cursor is used to retrieve the next set of query results.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "Maximum number of results to return per page. Must be between 1 and 50. Default is 50. If outside this range, an error is returned.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the specified limit is less than 1 or greater than 50, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 50.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCustomerSegments'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/segments", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by previous calls to `ListCustomerSegments`.\nThis cursor is used to retrieve the next set of query results.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by previous calls to `ListCustomerSegments`.\nThis cursor is used to retrieve the next set of query results.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the specified limit is less than 1 or greater than 50, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 50.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the specified limit is less than 1 or greater than 50, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 50.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDeviceCodes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDeviceCodes.json new file mode 100644 index 00000000..be1e7513 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDeviceCodes.json @@ -0,0 +1,215 @@ +{ + "name": "ListDeviceCodes", + "fully_qualified_name": "SquareupApi.ListDeviceCodes@0.1.0", + "description": "Retrieve all device codes for the merchant.\n\nThis tool retrieves all device codes associated with a merchant account on Square. It should be called when there's a need to list or manage the devices linked to a merchant.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor from a previous call, used to retrieve the next set of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Paginating results](https://developer.squareup.com/docs/working-with-apis/pagination) for more information." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "filter_by_location_id", + "required": false, + "description": "Specify a location to return only its DeviceCodes. Leave empty to return codes from all locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If specified, only returns DeviceCodes of the specified location.\nReturns DeviceCodes of all locations if empty." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "filter_by_product_type", + "required": false, + "description": "Specify a product type to target specific DeviceCodes. Use 'TERMINAL_API' or leave empty for all types.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "TERMINAL_API" + ], + "properties": null, + "inner_properties": null, + "description": "If specified, only returns DeviceCodes targeting the specified product type.\nReturns DeviceCodes of all product types if empty." + }, + "inferrable": true, + "http_endpoint_parameter_name": "product_type" + }, + { + "name": "device_code_status", + "required": false, + "description": "Specifies the status of DeviceCodes to return. Options: UNKNOWN, UNPAIRED, PAIRED, EXPIRED. Returns PAIRED and UNPAIRED if empty.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "UNKNOWN", + "UNPAIRED", + "PAIRED", + "EXPIRED" + ], + "properties": null, + "inner_properties": null, + "description": "If specified, returns DeviceCodes with the specified statuses.\nReturns DeviceCodes of status `PAIRED` and `UNPAIRED` if empty." + }, + "inferrable": true, + "http_endpoint_parameter_name": "status" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListDeviceCodes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DEVICE_CREDENTIAL_MANAGEMENT" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/devices/codes", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Paginating results](https://developer.squareup.com/docs/working-with-apis/pagination) for more information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Paginating results](https://developer.squareup.com/docs/working-with-apis/pagination) for more information." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "filter_by_location_id", + "description": "If specified, only returns DeviceCodes of the specified location.\nReturns DeviceCodes of all locations if empty.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If specified, only returns DeviceCodes of the specified location.\nReturns DeviceCodes of all locations if empty." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "product_type", + "tool_parameter_name": "filter_by_product_type", + "description": "If specified, only returns DeviceCodes targeting the specified product type.\nReturns DeviceCodes of all product types if empty.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "TERMINAL_API" + ], + "properties": null, + "inner_properties": null, + "description": "If specified, only returns DeviceCodes targeting the specified product type.\nReturns DeviceCodes of all product types if empty." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "status", + "tool_parameter_name": "device_code_status", + "description": "If specified, returns DeviceCodes with the specified statuses.\nReturns DeviceCodes of status `PAIRED` and `UNPAIRED` if empty.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "UNKNOWN", + "UNPAIRED", + "PAIRED", + "EXPIRED" + ], + "properties": null, + "inner_properties": null, + "description": "If specified, returns DeviceCodes with the specified statuses.\nReturns DeviceCodes of status `PAIRED` and `UNPAIRED` if empty." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDisputeEvidence.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDisputeEvidence.json new file mode 100644 index 00000000..cf28206d --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListDisputeEvidence.json @@ -0,0 +1,137 @@ +{ + "name": "ListDisputeEvidence", + "fully_qualified_name": "SquareupApi.ListDisputeEvidence@0.1.0", + "description": "Retrieve evidence related to a specific dispute.\n\nUse this tool to obtain a list of all evidence associated with a particular dispute by specifying the dispute ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "dispute_id", + "required": true, + "description": "The unique identifier of the dispute for which evidence is being requested.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute." + }, + "inferrable": true, + "http_endpoint_parameter_name": "dispute_id" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor to retrieve the next set of results for the original query.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListDisputeEvidence'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DISPUTES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/disputes/{dispute_id}/evidence", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "dispute_id", + "tool_parameter_name": "dispute_id", + "description": "The ID of the dispute.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListEventTypes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListEventTypes.json new file mode 100644 index 00000000..8e2f6a62 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListEventTypes.json @@ -0,0 +1,101 @@ +{ + "name": "ListEventTypes", + "fully_qualified_name": "SquareupApi.ListEventTypes@0.1.0", + "description": "Retrieve all event types available for webhooks and querying.\n\nUse this tool to list all the event types you can subscribe to as webhooks or query via the Events API. It helps in understanding which events are trackable and can be used for notifications or further analysis.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "api_version", + "required": false, + "description": "Specify the API version to list event types. This overrides the default application version.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The API version for which to list event types. Setting this field overrides the default version used by the application." + }, + "inferrable": true, + "http_endpoint_parameter_name": "api_version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListEventTypes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/events/types", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "api_version", + "tool_parameter_name": "api_version", + "description": "The API version for which to list event types. Setting this field overrides the default version used by the application.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The API version for which to list event types. Setting this field overrides the default version used by the application." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCardActivities.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCardActivities.json new file mode 100644 index 00000000..da8afde3 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCardActivities.json @@ -0,0 +1,329 @@ +{ + "name": "ListGiftCardActivities", + "fully_qualified_name": "SquareupApi.ListGiftCardActivities@0.1.0", + "description": "Retrieve and filter gift card activities for a seller.\n\nLists gift card activities from the seller's account. Optionally filter the activities by gift card, region, or within a specific time window.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "gift_card_id", + "required": false, + "description": "Specify a gift card ID to return activities related to that gift card. Leave empty to return all gift card activities for the seller.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a gift card ID is provided, the endpoint returns activities related \nto the specified gift card. Otherwise, the endpoint returns all gift card activities for \nthe seller." + }, + "inferrable": true, + "http_endpoint_parameter_name": "gift_card_id" + }, + { + "name": "activity_type", + "required": false, + "description": "Filter gift card activities by specifying a particular activity type. If not provided, returns all activity types.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a [type](entity:GiftCardActivityType) is provided, the endpoint returns gift card activities of the specified type. \nOtherwise, the endpoint returns all types of gift card activities." + }, + "inferrable": true, + "http_endpoint_parameter_name": "type" + }, + { + "name": "location_id", + "required": false, + "description": "Specify the location ID to filter gift card activities for a particular location. Leave empty to return activities for all locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a location ID is provided, the endpoint returns gift card activities for the specified location. \nOtherwise, the endpoint returns gift card activities for all locations." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "reporting_start_time", + "required": false, + "description": "The starting timestamp for the reporting period, in RFC 3339 format. Includes this date and time. Defaults to one year prior from now if not specified.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the beginning of the reporting period, in RFC 3339 format.\nThis start time is inclusive. The default value is the current time minus one year." + }, + "inferrable": true, + "http_endpoint_parameter_name": "begin_time" + }, + { + "name": "end_time", + "required": false, + "description": "The inclusive end timestamp for the reporting period in RFC 3339 format. Defaults to current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the end of the reporting period, in RFC 3339 format.\nThis end time is inclusive. The default value is the current time." + }, + "inferrable": true, + "http_endpoint_parameter_name": "end_time" + }, + { + "name": "result_limit", + "required": false, + "description": "Specify the maximum number of results per page. Default is 50, maximum allowed is 100.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a limit is provided, the endpoint returns the specified number \nof results (or fewer) per page. The maximum value is 100. The default value is 50.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor from a previous call to get the next set of results. If not provided, the first page is returned.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "activities_sort_order", + "required": false, + "description": "Defines the order of gift card activities based on creation date. Use 'ASC' for oldest to newest, or 'DESC' for newest to oldest (default).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The order in which the endpoint returns the activities, based on `created_at`.\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListGiftCardActivities'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "GIFTCARDS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/gift-cards/activities", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "gift_card_id", + "tool_parameter_name": "gift_card_id", + "description": "If a gift card ID is provided, the endpoint returns activities related \nto the specified gift card. Otherwise, the endpoint returns all gift card activities for \nthe seller.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a gift card ID is provided, the endpoint returns activities related \nto the specified gift card. Otherwise, the endpoint returns all gift card activities for \nthe seller." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "type", + "tool_parameter_name": "activity_type", + "description": "If a [type](entity:GiftCardActivityType) is provided, the endpoint returns gift card activities of the specified type. \nOtherwise, the endpoint returns all types of gift card activities.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a [type](entity:GiftCardActivityType) is provided, the endpoint returns gift card activities of the specified type. \nOtherwise, the endpoint returns all types of gift card activities." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "If a location ID is provided, the endpoint returns gift card activities for the specified location. \nOtherwise, the endpoint returns gift card activities for all locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a location ID is provided, the endpoint returns gift card activities for the specified location. \nOtherwise, the endpoint returns gift card activities for all locations." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "begin_time", + "tool_parameter_name": "reporting_start_time", + "description": "The timestamp for the beginning of the reporting period, in RFC 3339 format.\nThis start time is inclusive. The default value is the current time minus one year.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the beginning of the reporting period, in RFC 3339 format.\nThis start time is inclusive. The default value is the current time minus one year." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "end_time", + "tool_parameter_name": "end_time", + "description": "The timestamp for the end of the reporting period, in RFC 3339 format.\nThis end time is inclusive. The default value is the current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The timestamp for the end of the reporting period, in RFC 3339 format.\nThis end time is inclusive. The default value is the current time." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "result_limit", + "description": "If a limit is provided, the endpoint returns the specified number \nof results (or fewer) per page. The maximum value is 100. The default value is 50.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a limit is provided, the endpoint returns the specified number \nof results (or fewer) per page. The maximum value is 100. The default value is 50.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "activities_sort_order", + "description": "The order in which the endpoint returns the activities, based on `created_at`.\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The order in which the endpoint returns the activities, based on `created_at`.\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCards.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCards.json new file mode 100644 index 00000000..d2f1a691 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListGiftCards.json @@ -0,0 +1,233 @@ +{ + "name": "ListGiftCards", + "fully_qualified_name": "SquareupApi.ListGiftCards@0.1.0", + "description": "Retrieve a list of all gift cards, with optional filters.\n\nCall this tool to obtain a sorted list of gift cards. You can apply filters to narrow down the results. Useful for managing and reviewing available gift cards.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "gift_card_type", + "required": false, + "description": "Specifies the type of gift cards to retrieve. If not provided, all types are returned.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a [type](entity:GiftCardType) is provided, the endpoint returns gift cards of the specified type.\nOtherwise, the endpoint returns gift cards of all types." + }, + "inferrable": true, + "http_endpoint_parameter_name": "type" + }, + { + "name": "gift_card_state", + "required": false, + "description": "Specifies the state of gift cards to return. Leave empty to get all states.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a [state](entity:GiftCardStatus) is provided, the endpoint returns the gift cards in the specified state.\nOtherwise, the endpoint returns the gift cards of all states." + }, + "inferrable": true, + "http_endpoint_parameter_name": "state" + }, + { + "name": "results_per_page_limit", + "required": false, + "description": "The number of gift card results per page. Maximum is 200, default is 30.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a limit is provided, the endpoint returns only the specified number of results per page.\nThe maximum value is 200. The default value is 30.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A string used to retrieve the next set of results for pagination from a previous call.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "customer_id", + "required": false, + "description": "A unique identifier for a customer to retrieve gift cards linked to them.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a customer ID is provided, the endpoint returns only the gift cards linked to the specified customer." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListGiftCards'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "GIFTCARDS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/gift-cards", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "type", + "tool_parameter_name": "gift_card_type", + "description": "If a [type](entity:GiftCardType) is provided, the endpoint returns gift cards of the specified type.\nOtherwise, the endpoint returns gift cards of all types.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a [type](entity:GiftCardType) is provided, the endpoint returns gift cards of the specified type.\nOtherwise, the endpoint returns gift cards of all types." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "state", + "tool_parameter_name": "gift_card_state", + "description": "If a [state](entity:GiftCardStatus) is provided, the endpoint returns the gift cards in the specified state.\nOtherwise, the endpoint returns the gift cards of all states.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a [state](entity:GiftCardStatus) is provided, the endpoint returns the gift cards in the specified state.\nOtherwise, the endpoint returns the gift cards of all states." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "results_per_page_limit", + "description": "If a limit is provided, the endpoint returns only the specified number of results per page.\nThe maximum value is 200. The default value is 30.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a limit is provided, the endpoint returns only the specified number of results per page.\nThe maximum value is 200. The default value is 30.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "customer_id", + "tool_parameter_name": "customer_id", + "description": "If a customer ID is provided, the endpoint returns only the gift cards linked to the specified customer.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If a customer ID is provided, the endpoint returns only the gift cards linked to the specified customer." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListInvoices.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListInvoices.json new file mode 100644 index 00000000..5412b281 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListInvoices.json @@ -0,0 +1,169 @@ +{ + "name": "ListInvoices", + "fully_qualified_name": "SquareupApi.ListInvoices@0.1.0", + "description": "Retrieve a list of invoices for a specified location.\n\nUse this tool to get a list of invoices from a specific location. The response is paginated, and if the list is truncated, a cursor is provided to fetch the next set of invoices.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": true, + "description": "The ID of the location for which to list invoices.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to list invoices." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A string value used to fetch the next set of paginated results for invoices. This is returned from a previous call to the list invoices endpoint.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint. \nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "maximum_invoices_to_return", + "required": false, + "description": "The maximum number of invoices to return, up to 200. Defaults to 100 if not specified.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of invoices to return (200 is the maximum `limit`). \nIf not provided, the server uses a default limit of 100 invoices." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListInvoices'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "INVOICES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/invoices", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the location for which to list invoices.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to list invoices." + }, + "accepted_as": "query", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint. \nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint. \nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "maximum_invoices_to_return", + "description": "The maximum number of invoices to return (200 is the maximum `limit`). \nIf not provided, the server uses a default limit of 100 invoices.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of invoices to return (200 is the maximum `limit`). \nIf not provided, the server uses a default limit of 100 invoices." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListJobsForSeller.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListJobsForSeller.json new file mode 100644 index 00000000..03f05db8 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListJobsForSeller.json @@ -0,0 +1,105 @@ +{ + "name": "ListJobsForSeller", + "fully_qualified_name": "SquareupApi.ListJobsForSeller@0.1.0", + "description": "Retrieve a list of jobs in a seller account.\n\nThis tool retrieves a list of jobs associated with a seller account, sorted by title in ascending order. Use this tool when you need to view or manage the job listings for a seller.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "The cursor for pagination to retrieve the next page of job results. Obtain this from the previous response.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor returned by the previous call to this endpoint. Provide this\ncursor to retrieve the next page of results for your original request. For more information,\nsee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListJobs'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "EMPLOYEES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/team-members/jobs", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The pagination cursor returned by the previous call to this endpoint. Provide this\ncursor to retrieve the next page of results for your original request. For more information,\nsee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor returned by the previous call to this endpoint. Provide this\ncursor to retrieve the next page of results for your original request. For more information,\nsee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationBookingProfiles.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationBookingProfiles.json new file mode 100644 index 00000000..c74ebd40 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationBookingProfiles.json @@ -0,0 +1,137 @@ +{ + "name": "ListLocationBookingProfiles", + "fully_qualified_name": "SquareupApi.ListLocationBookingProfiles@0.1.0", + "description": "Lists location booking profiles of a seller.\n\nUse this tool to retrieve a list of all the booking profiles associated with a seller's locations from Squareup.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "maximum_results_per_page", + "required": false, + "description": "The maximum number of booking profiles to retrieve in one page of the response.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a paged response." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Use this to provide the pagination cursor from the previous response to get the next set of results. Leave unset for the first page.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListLocationBookingProfiles'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_BUSINESS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/location-booking-profiles", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a paged response.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a paged response." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributeDefinitions.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributeDefinitions.json new file mode 100644 index 00000000..aebdd429 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributeDefinitions.json @@ -0,0 +1,177 @@ +{ + "name": "ListLocationCustomAttributeDefinitions", + "fully_qualified_name": "SquareupApi.ListLocationCustomAttributeDefinitions@0.1.0", + "description": "Retrieve location custom attribute definitions for a Square account.\n\nThis tool retrieves all location-related custom attribute definitions for a Square seller account. It includes those visible to the requesting application, even if created by other applications. Use this to access custom attribute definitions with various visibility settings.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "filter_by_visibility", + "required": false, + "description": "Filter the results by visibility values: ALL, READ, or READ_WRITE.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "inferrable": true, + "http_endpoint_parameter_name": "visibility_filter" + }, + { + "name": "maximum_results_per_page", + "required": false, + "description": "Maximum number of results to return per page. Minimum is 1, maximum is 100, default is 20. Advisory only, may vary.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The cursor for retrieving the next page of results from a previous call. Use this for pagination handling.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListLocationCustomAttributeDefinitions'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations/custom-attribute-definitions", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "visibility_filter", + "tool_parameter_name": "filter_by_visibility", + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributes.json new file mode 100644 index 00000000..72dcce58 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLocationCustomAttributes.json @@ -0,0 +1,241 @@ +{ + "name": "ListLocationCustomAttributes", + "fully_qualified_name": "SquareupApi.ListLocationCustomAttributes@0.1.0", + "description": "Fetch custom attributes for a specific location.\n\nUse this tool to list custom attributes associated with a specific location. It can also retrieve custom attribute definitions if needed. It includes attributes visible to the requesting app, even if owned by others.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": true, + "description": "The ID of the target location for which to fetch custom attributes.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [location](entity:Location)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "visibility_filter", + "required": false, + "description": "Filters custom attribute results based on their visibility values (ALL, READ, READ_WRITE).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "inferrable": true, + "http_endpoint_parameter_name": "visibility_filter" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "The maximum number of results to fetch per page. Minimum is 1, maximum is 100, default is 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "String value of the cursor from previous response, used for paginating results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "include_custom_attribute_definitions", + "required": false, + "description": "Set to true to include custom attribute definitions with each custom attribute. Default is false.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definitions" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListLocationCustomAttributes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations/{location_id}/custom-attributes", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "visibility_filter", + "tool_parameter_name": "visibility_filter", + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "with_definitions", + "tool_parameter_name": "include_custom_attribute_definitions", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the target [location](entity:Location).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [location](entity:Location)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLoyaltyPromotions.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLoyaltyPromotions.json new file mode 100644 index 00000000..e9ed7e2e --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListLoyaltyPromotions.json @@ -0,0 +1,211 @@ +{ + "name": "ListLoyaltyPromotions", + "fully_qualified_name": "SquareupApi.ListLoyaltyPromotions@0.1.0", + "description": "Fetches loyalty promotions for a specific program.\n\nUse this tool to retrieve a list of loyalty promotions linked to a specific loyalty program, sorted by their creation date, from newest to oldest.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "loyalty_program_id", + "required": true, + "description": "The ID of the base loyalty program. Use the 'RetrieveLoyaltyProgram' API with 'main' to get this ID.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram). To get the program ID,\ncall [RetrieveLoyaltyProgram](api-endpoint:Loyalty-RetrieveLoyaltyProgram) using the `main` keyword." + }, + "inferrable": true, + "http_endpoint_parameter_name": "program_id" + }, + { + "name": "filter_by_status", + "required": false, + "description": "Filter loyalty promotions by status. Options: ACTIVE, ENDED, CANCELED, SCHEDULED.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ACTIVE", + "ENDED", + "CANCELED", + "SCHEDULED" + ], + "properties": null, + "inner_properties": null, + "description": "The status to filter the results by. If a status is provided, only loyalty promotions\nwith the specified status are returned. Otherwise, all loyalty promotions associated with\nthe loyalty program are returned." + }, + "inferrable": true, + "http_endpoint_parameter_name": "status" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The cursor for retrieving the next page of loyalty promotions. Obtain this from the previous response to continue pagination.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "Specifies the maximum number of loyalty promotions to return per page. Must be between 1 and 30. Default is 30.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response.\nThe minimum value is 1 and the maximum value is 30. The default value is 30.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListLoyaltyPromotions'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "LOYALTY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/loyalty/programs/{program_id}/promotions", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "status", + "tool_parameter_name": "filter_by_status", + "description": "The status to filter the results by. If a status is provided, only loyalty promotions\nwith the specified status are returned. Otherwise, all loyalty promotions associated with\nthe loyalty program are returned.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ACTIVE", + "ENDED", + "CANCELED", + "SCHEDULED" + ], + "properties": null, + "inner_properties": null, + "description": "The status to filter the results by. If a status is provided, only loyalty promotions\nwith the specified status are returned. Otherwise, all loyalty promotions associated with\nthe loyalty program are returned." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to return in a single paged response.\nThe minimum value is 1 and the maximum value is 30. The default value is 30.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response.\nThe minimum value is 1 and the maximum value is 30. The default value is 30.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "program_id", + "tool_parameter_name": "loyalty_program_id", + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram). To get the program ID,\ncall [RetrieveLoyaltyProgram](api-endpoint:Loyalty-RetrieveLoyaltyProgram) using the `main` keyword.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram). To get the program ID,\ncall [RetrieveLoyaltyProgram](api-endpoint:Loyalty-RetrieveLoyaltyProgram) using the `main` keyword." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributeDefinitions.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributeDefinitions.json new file mode 100644 index 00000000..52cf256c --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributeDefinitions.json @@ -0,0 +1,177 @@ +{ + "name": "ListMerchantCustomAttributeDefinitions", + "fully_qualified_name": "SquareupApi.ListMerchantCustomAttributeDefinitions@0.1.0", + "description": "Retrieve custom attribute definitions for a Square seller account.\n\nLists all visible merchant-related custom attribute definitions for a Square seller account, including those created by other applications.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "filter_by_visibility", + "required": false, + "description": "Specify the visibility to filter custom attribute definitions. Options: 'ALL', 'READ', 'READ_WRITE'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "inferrable": true, + "http_endpoint_parameter_name": "visibility_filter" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "Specifies the maximum number of results to return per page. Valid values are between 1 and 100. Defaults to 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Cursor to retrieve the next page of results from a previous API call response.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListMerchantCustomAttributeDefinitions'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants/custom-attribute-definitions", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "visibility_filter", + "tool_parameter_name": "filter_by_visibility", + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributes.json new file mode 100644 index 00000000..13300023 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantCustomAttributes.json @@ -0,0 +1,241 @@ +{ + "name": "ListMerchantCustomAttributes", + "fully_qualified_name": "SquareupApi.ListMerchantCustomAttributes@0.1.0", + "description": "Retrieve custom attributes for a specified merchant.\n\nUse this tool to get custom attributes associated with a merchant. You can optionally include definitions of these attributes. The tool returns all attributes visible to the requesting application, including those with read-only or read-write visibility.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "merchant_id", + "required": true, + "description": "The ID of the target merchant. Use this to specify which merchant's custom attributes you want to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [merchant](entity:Merchant)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "merchant_id" + }, + { + "name": "filter_by_visibility", + "required": false, + "description": "Specify how to filter custom attribute definitions by visibility. Options: 'ALL', 'READ', 'READ_WRITE'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "inferrable": true, + "http_endpoint_parameter_name": "visibility_filter" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "Maximum number of results per single paged response. Value must be between 1 and 100, with a default of 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The cursor from the previous response to retrieve the next page of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "include_custom_attribute_definitions", + "required": false, + "description": "Set to `true` to include custom attribute definitions, including their name, description, and data type. Default is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definitions" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListMerchantCustomAttributes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants/{merchant_id}/custom-attributes", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "visibility_filter", + "tool_parameter_name": "filter_by_visibility", + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Filters the `CustomAttributeDefinition` results by their `visibility` values." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory.\nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.\nThe default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint.\nProvide this cursor to retrieve the next page of results for your original request. For more\ninformation, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "with_definitions", + "tool_parameter_name": "include_custom_attribute_definitions", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "merchant_id", + "tool_parameter_name": "merchant_id", + "description": "The ID of the target [merchant](entity:Merchant).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [merchant](entity:Merchant)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantDevices.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantDevices.json new file mode 100644 index 00000000..a9b564d0 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListMerchantDevices.json @@ -0,0 +1,207 @@ +{ + "name": "ListMerchantDevices", + "fully_qualified_name": "SquareupApi.ListMerchantDevices@0.1.0", + "description": "Retrieve a list of merchant's connected devices.\n\nCall this tool to obtain a list of devices associated with a merchant, specifically Terminal API devices, using the Squareup service.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor from a previous call to retrieve the next set of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "result_sort_order", + "required": false, + "description": "Specifies whether to list results from oldest to newest ('ASC') or newest to oldest ('DESC'). Default is 'DESC'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which results are listed.\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "results_per_page", + "required": false, + "description": "The number of device results to return in a single API call.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The number of results to return in a single page." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "filter_by_location_id", + "required": false, + "description": "Return devices only at the specified location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If present, only returns devices at the target location." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListDevices'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DEVICES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/devices", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "result_sort_order", + "description": "The order in which results are listed.\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which results are listed.\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "results_per_page", + "description": "The number of results to return in a single page.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The number of results to return in a single page." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "filter_by_location_id", + "description": "If present, only returns devices at the target location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If present, only returns devices at the target location." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributeDefinitions.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributeDefinitions.json new file mode 100644 index 00000000..063e3bf8 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributeDefinitions.json @@ -0,0 +1,177 @@ +{ + "name": "ListOrderCustomAttributeDefinitions", + "fully_qualified_name": "SquareupApi.ListOrderCustomAttributeDefinitions@0.1.0", + "description": "Retrieve order-related custom attribute definitions for a Square seller.\n\nUse this tool to list all order-related custom attribute definitions for a Square seller account. It includes attributes visible to the requesting application, even those created by other applications, with various visibility settings.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_visibility_filter", + "required": false, + "description": "Specifies which custom attributes to return: all, read-only, or read-write.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Requests that all of the custom attributes be returned, or only those that are read-only or read-write." + }, + "inferrable": true, + "http_endpoint_parameter_name": "visibility_filter" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The cursor from the previous response to get the next page of results. See [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint. \nProvide this cursor to retrieve the next page of results for your original request. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "maximum_results_per_page", + "required": false, + "description": "The maximum number of results to return in a single paged response. Minimum is 1, maximum is 100. Default is 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory. \nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. \nThe default value is 20.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListOrderCustomAttributeDefinitions'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/orders/custom-attribute-definitions", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "visibility_filter", + "tool_parameter_name": "custom_attribute_visibility_filter", + "description": "Requests that all of the custom attributes be returned, or only those that are read-only or read-write.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Requests that all of the custom attributes be returned, or only those that are read-only or read-write." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint. \nProvide this cursor to retrieve the next page of results for your original request. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint. \nProvide this cursor to retrieve the next page of results for your original request. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory. \nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. \nThe default value is 20.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory. \nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. \nThe default value is 20.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributes.json new file mode 100644 index 00000000..c73d51ee --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListOrderCustomAttributes.json @@ -0,0 +1,241 @@ +{ + "name": "ListOrderCustomAttributes", + "fully_qualified_name": "SquareupApi.ListOrderCustomAttributes@0.1.0", + "description": "Retrieve custom attributes linked to a specific order.\n\nThis tool retrieves custom attribute details for a specified order, including all attributes visible to the requesting application across different visibility settings. It supports fetching custom attribute definitions as well.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "target_order_id", + "required": true, + "description": "The ID of the specific order for which to retrieve custom attributes.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [order](entity:Order)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "order_id" + }, + { + "name": "attribute_visibility_filter", + "required": false, + "description": "Select which custom attributes to return: 'ALL' for all, 'READ' for read-only, 'READ_WRITE' for read-write attributes.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Requests that all of the custom attributes be returned, or only those that are read-only or read-write." + }, + "inferrable": true, + "http_endpoint_parameter_name": "visibility_filter" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The pagination cursor from the previous response to retrieve the next page of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint. \nProvide this cursor to retrieve the next page of results for your original request. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "The maximum number of results to return in a single paged response. Accepts an integer between 1 and 100. Default is 20.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory. \nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. \nThe default value is 20.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "include_custom_attribute_definitions", + "required": false, + "description": "Set to true to include custom attribute definitions with the order attributes. Default is false.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom attribute, \ninformation about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definitions" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListOrderCustomAttributes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/orders/{order_id}/custom-attributes", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "visibility_filter", + "tool_parameter_name": "attribute_visibility_filter", + "description": "Requests that all of the custom attributes be returned, or only those that are read-only or read-write.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "ALL", + "READ", + "READ_WRITE" + ], + "properties": null, + "inner_properties": null, + "description": "Requests that all of the custom attributes be returned, or only those that are read-only or read-write." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The cursor returned in the paged response from the previous call to this endpoint. \nProvide this cursor to retrieve the next page of results for your original request. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The cursor returned in the paged response from the previous call to this endpoint. \nProvide this cursor to retrieve the next page of results for your original request. \nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to return in a single paged response. This limit is advisory. \nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. \nThe default value is 20.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single paged response. This limit is advisory. \nThe response might contain more or fewer results. The minimum value is 1 and the maximum value is 100. \nThe default value is 20.\nFor more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "with_definitions", + "tool_parameter_name": "include_custom_attribute_definitions", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom attribute, \ninformation about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each\ncustom attribute. Set this parameter to `true` to get the name and description of each custom attribute, \ninformation about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "order_id", + "tool_parameter_name": "target_order_id", + "description": "The ID of the target [order](entity:Order).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [order](entity:Order)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentLinks.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentLinks.json new file mode 100644 index 00000000..25a7955a --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentLinks.json @@ -0,0 +1,137 @@ +{ + "name": "ListPaymentLinks", + "fully_qualified_name": "SquareupApi.ListPaymentLinks@0.1.0", + "description": "Retrieve all available payment links from Squareup.\n\nUse this tool to list all payment links generated in your Squareup account. It helps in managing and reviewing payment links efficiently.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A string cursor for paginating results. Use it to fetch the next set of results from a previous query. Leave blank to get the first page.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "results_per_page_limit", + "required": false, + "description": "Sets the maximum number of payment links to return per page. Defaults to 100, ignored if negative or exceeds 1000.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A limit on the number of results to return per page. The limit is advisory and\nthe implementation might return more or less results. If the supplied limit is negative, zero, or\ngreater than the maximum limit of 1000, it is ignored.\n\nDefault value: `100`" + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListPaymentLinks'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/online-checkout/payment-links", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nIf a cursor is not provided, the endpoint returns the first page of the results.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "results_per_page_limit", + "description": "A limit on the number of results to return per page. The limit is advisory and\nthe implementation might return more or less results. If the supplied limit is negative, zero, or\ngreater than the maximum limit of 1000, it is ignored.\n\nDefault value: `100`", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A limit on the number of results to return per page. The limit is advisory and\nthe implementation might return more or less results. If the supplied limit is negative, zero, or\ngreater than the maximum limit of 1000, it is ignored.\n\nDefault value: `100`" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentRefunds.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentRefunds.json new file mode 100644 index 00000000..e5f6617d --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPaymentRefunds.json @@ -0,0 +1,431 @@ +{ + "name": "ListPaymentRefunds", + "fully_qualified_name": "SquareupApi.ListPaymentRefunds@0.1.0", + "description": "Retrieve a list of payment refunds for the account.\n\nFetches a list of refunds associated with the account making the request. Suitable for monitoring refund transactions, with a maximum of 100 results per page. Results may take several seconds to update due to eventual consistency.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "start_time_for_refund_retrieval", + "required": false, + "description": "Start of the time range for retrieving PaymentRefund in RFC 3339 format, based on the created_at field. Defaults to one year ago.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve each `PaymentRefund` for, in RFC 3339 \nformat. The range is determined using the `created_at` field for each `PaymentRefund`. \n\nDefault: The current time minus one year." + }, + "inferrable": true, + "http_endpoint_parameter_name": "begin_time" + }, + { + "name": "refund_end_time", + "required": false, + "description": "Specifies the end date and time for the refund retrieval range in RFC 3339 format, defaulting to the current time if not specified.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339 \nformat. The range is determined using the `created_at` field for each `PaymentRefund`.\n\nDefault: The current time." + }, + "inferrable": true, + "http_endpoint_parameter_name": "end_time" + }, + { + "name": "results_sort_order", + "required": false, + "description": "Set the order for listing results by `PaymentRefund.created_at`. Use 'ASC' for oldest to newest, 'DESC' for newest to oldest (default).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The order in which results are listed by `PaymentRefund.created_at`:\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor from a previous call to retrieve the next set of results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "limit_results_to_location", + "required": false, + "description": "Specify the location ID to filter results for that location. Defaults to all seller-associated locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to the location supplied. By default, results are returned\nfor all locations associated with the seller." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "refund_status_filter", + "required": false, + "description": "Filter refunds by specific status. Uses status values defined in PaymentRefund entity. If omitted, all statuses are included.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If provided, only refunds with the given status are returned.\nFor a list of refund status values, see [PaymentRefund](entity:PaymentRefund).\n\nDefault: If omitted, refunds are returned regardless of their status." + }, + "inferrable": true, + "http_endpoint_parameter_name": "status" + }, + { + "name": "payment_source_type", + "required": false, + "description": "Specify the source type of payments to filter refunds. Options: CARD, BANK_ACCOUNT, WALLET, CASH, EXTERNAL. If omitted, all source types are included.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If provided, only returns refunds whose payments have the indicated source type.\nCurrent values include `CARD`, `BANK_ACCOUNT`, `WALLET`, `CASH`, and `EXTERNAL`.\nFor information about these payment source types, see\n[Take Payments](https://developer.squareup.com/docs/payments-api/take-payments).\n\nDefault: If omitted, refunds are returned regardless of the source type." + }, + "inferrable": true, + "http_endpoint_parameter_name": "source_type" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "Specify the maximum number of refund results per page, up to a maximum of 100.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\n\nIt is possible to receive fewer results than the specified limit on a given page.\n\nIf the supplied value is greater than 100, no more than 100 results are returned.\n\nDefault: 100" + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "updated_at_start_time", + "required": false, + "description": "The start of the time range for retrieving refunds, based on the `updated_at` field, in RFC 3339 format. Defaults to `begin_time` if omitted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve each `PaymentRefund` for, in RFC 3339\nformat. The range is determined using the `updated_at` field for each `PaymentRefund`.\n\nDefault: If omitted, the time range starts at `begin_time`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "updated_at_begin_time" + }, + { + "name": "updated_at_end_time", + "required": false, + "description": "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339 format. Defaults to the current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339\nformat. The range is determined using the `updated_at` field for each `PaymentRefund`.\n\nDefault: The current time." + }, + "inferrable": true, + "http_endpoint_parameter_name": "updated_at_end_time" + }, + { + "name": "sort_results_by_field", + "required": false, + "description": "Specifies the field to sort refund results by. Options are 'CREATED_AT' or 'UPDATED_AT'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "CREATED_AT", + "UPDATED_AT" + ], + "properties": null, + "inner_properties": null, + "description": "The field used to sort results by. The default is `CREATED_AT`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_field" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListPaymentRefunds'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/refunds", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "begin_time", + "tool_parameter_name": "start_time_for_refund_retrieval", + "description": "Indicates the start of the time range to retrieve each `PaymentRefund` for, in RFC 3339 \nformat. The range is determined using the `created_at` field for each `PaymentRefund`. \n\nDefault: The current time minus one year.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve each `PaymentRefund` for, in RFC 3339 \nformat. The range is determined using the `created_at` field for each `PaymentRefund`. \n\nDefault: The current time minus one year." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "end_time", + "tool_parameter_name": "refund_end_time", + "description": "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339 \nformat. The range is determined using the `created_at` field for each `PaymentRefund`.\n\nDefault: The current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339 \nformat. The range is determined using the `created_at` field for each `PaymentRefund`.\n\nDefault: The current time." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "results_sort_order", + "description": "The order in which results are listed by `PaymentRefund.created_at`:\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The order in which results are listed by `PaymentRefund.created_at`:\n- `ASC` - Oldest to newest.\n- `DESC` - Newest to oldest (default)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "limit_results_to_location", + "description": "Limit results to the location supplied. By default, results are returned\nfor all locations associated with the seller.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to the location supplied. By default, results are returned\nfor all locations associated with the seller." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "status", + "tool_parameter_name": "refund_status_filter", + "description": "If provided, only refunds with the given status are returned.\nFor a list of refund status values, see [PaymentRefund](entity:PaymentRefund).\n\nDefault: If omitted, refunds are returned regardless of their status.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If provided, only refunds with the given status are returned.\nFor a list of refund status values, see [PaymentRefund](entity:PaymentRefund).\n\nDefault: If omitted, refunds are returned regardless of their status." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "source_type", + "tool_parameter_name": "payment_source_type", + "description": "If provided, only returns refunds whose payments have the indicated source type.\nCurrent values include `CARD`, `BANK_ACCOUNT`, `WALLET`, `CASH`, and `EXTERNAL`.\nFor information about these payment source types, see\n[Take Payments](https://developer.squareup.com/docs/payments-api/take-payments).\n\nDefault: If omitted, refunds are returned regardless of the source type.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If provided, only returns refunds whose payments have the indicated source type.\nCurrent values include `CARD`, `BANK_ACCOUNT`, `WALLET`, `CASH`, and `EXTERNAL`.\nFor information about these payment source types, see\n[Take Payments](https://developer.squareup.com/docs/payments-api/take-payments).\n\nDefault: If omitted, refunds are returned regardless of the source type." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to be returned in a single page.\n\nIt is possible to receive fewer results than the specified limit on a given page.\n\nIf the supplied value is greater than 100, no more than 100 results are returned.\n\nDefault: 100", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\n\nIt is possible to receive fewer results than the specified limit on a given page.\n\nIf the supplied value is greater than 100, no more than 100 results are returned.\n\nDefault: 100" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "updated_at_begin_time", + "tool_parameter_name": "updated_at_start_time", + "description": "Indicates the start of the time range to retrieve each `PaymentRefund` for, in RFC 3339\nformat. The range is determined using the `updated_at` field for each `PaymentRefund`.\n\nDefault: If omitted, the time range starts at `begin_time`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the start of the time range to retrieve each `PaymentRefund` for, in RFC 3339\nformat. The range is determined using the `updated_at` field for each `PaymentRefund`.\n\nDefault: If omitted, the time range starts at `begin_time`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "updated_at_end_time", + "tool_parameter_name": "updated_at_end_time", + "description": "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339\nformat. The range is determined using the `updated_at` field for each `PaymentRefund`.\n\nDefault: The current time.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates the end of the time range to retrieve each `PaymentRefund` for, in RFC 3339\nformat. The range is determined using the `updated_at` field for each `PaymentRefund`.\n\nDefault: The current time." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_field", + "tool_parameter_name": "sort_results_by_field", + "description": "The field used to sort results by. The default is `CREATED_AT`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "CREATED_AT", + "UPDATED_AT" + ], + "properties": null, + "inner_properties": null, + "description": "The field used to sort results by. The default is `CREATED_AT`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPayoutEntries.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPayoutEntries.json new file mode 100644 index 00000000..9c9af6ae --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListPayoutEntries.json @@ -0,0 +1,203 @@ +{ + "name": "ListPayoutEntries", + "fully_qualified_name": "SquareupApi.ListPayoutEntries@0.1.0", + "description": "Retrieve all payout entries for a specific payout.\n\nFetches a list of all payout entries associated with a particular payout ID. Ideal for obtaining detailed payout information from Square.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "payout_id", + "required": true, + "description": "The unique ID of the payout to retrieve entries for. Essential for identifying the payout for which entries are needed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payout to retrieve the information for." + }, + "inferrable": true, + "http_endpoint_parameter_name": "payout_id" + }, + { + "name": "payout_entries_sort_order", + "required": false, + "description": "Specifies the order in which payout entries are listed. Use 'DESC' for descending or 'ASC' for ascending order.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which payout entries are listed." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Provide this cursor to retrieve the next set of results for the original query. A pagination cursor from a previous call.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).\nIf request parameters change between requests, subsequent results may contain duplicates or missing records." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "Sets the maximum number of results to retrieve per page, up to 100. Defaults to 100 if the value exceeds this limit.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value. If the provided value is\ngreater than 100, it is ignored and the default value is used instead.\nDefault: `100`" + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListPayoutEntries'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/payouts/{payout_id}/payout-entries", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "sort_order", + "tool_parameter_name": "payout_entries_sort_order", + "description": "The order in which payout entries are listed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "The order in which payout entries are listed." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).\nIf request parameters change between requests, subsequent results may contain duplicates or missing records.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).\nIf request parameters change between requests, subsequent results may contain duplicates or missing records." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value. If the provided value is\ngreater than 100, it is ignored and the default value is used instead.\nDefault: `100`", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value. If the provided value is\ngreater than 100, it is ignored and the default value is used instead.\nDefault: `100`" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "payout_id", + "tool_parameter_name": "payout_id", + "description": "The ID of the payout to retrieve the information for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the payout to retrieve the information for." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSellerLocations.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSellerLocations.json new file mode 100644 index 00000000..252b61a2 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSellerLocations.json @@ -0,0 +1,71 @@ +{ + "name": "ListSellerLocations", + "fully_qualified_name": "SquareupApi.ListSellerLocations@0.1.0", + "description": "Retrieve details of all seller locations from Square.\n\nCall this tool to get information about all the seller's locations, including inactive ones, retrieved in alphabetical order by name. Useful for managing or displaying seller location data.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'ListLocations'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations", + "http_method": "GET", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareCustomers.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareCustomers.json new file mode 100644 index 00000000..86a41791 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareCustomers.json @@ -0,0 +1,245 @@ +{ + "name": "ListSquareCustomers", + "fully_qualified_name": "SquareupApi.ListSquareCustomers@0.1.0", + "description": "Retrieve customer profiles from a Square account.\n\nUse this tool to obtain a list of customer profiles linked to a Square account. This is helpful for managing and analyzing customer data. Customer profiles may take some time to update, especially during network issues.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor to retrieve the next set of customer profiles. Use a cursor from a previous query call to fetch subsequent results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "maximum_results_per_page", + "required": false, + "description": "Specify the maximum number of customer profiles to return in a single page. Must be between 1 and 100, inclusive.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the specified limit is less than 1 or greater than 100, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 100.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "customer_sorting_field", + "required": false, + "description": "Specify how customer profiles should be sorted. Options are `DEFAULT` or `CREATED_AT`. Default is `DEFAULT`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DEFAULT", + "CREATED_AT" + ], + "properties": null, + "inner_properties": null, + "description": "Indicates how customers should be sorted.\n\nThe default value is `DEFAULT`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_field" + }, + { + "name": "customer_sort_order", + "required": false, + "description": "Specifies whether to sort customers in ascending ('ASC') or descending ('DESC') order. Default is 'ASC'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "Indicates whether customers should be sorted in ascending (`ASC`) or\ndescending (`DESC`) order.\n\nThe default value is `ASC`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "include_total_customer_count", + "required": false, + "description": "Set to true to include the total count of customers in the response. The default is false.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the total count of customers in the `count` field of the response.\n\nThe default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "count" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCustomers'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "maximum_results_per_page", + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the specified limit is less than 1 or greater than 100, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 100.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results.\nIf the specified limit is less than 1 or greater than 100, Square returns a `400 VALUE_TOO_LOW` or `400 VALUE_TOO_HIGH` error. The default value is 100.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_field", + "tool_parameter_name": "customer_sorting_field", + "description": "Indicates how customers should be sorted.\n\nThe default value is `DEFAULT`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DEFAULT", + "CREATED_AT" + ], + "properties": null, + "inner_properties": null, + "description": "Indicates how customers should be sorted.\n\nThe default value is `DEFAULT`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "customer_sort_order", + "description": "Indicates whether customers should be sorted in ascending (`ASC`) or\ndescending (`DESC`) order.\n\nThe default value is `ASC`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "Indicates whether customers should be sorted in ascending (`ASC`) or\ndescending (`DESC`) order.\n\nThe default value is `ASC`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "count", + "tool_parameter_name": "include_total_customer_count", + "description": "Indicates whether to return the total count of customers in the `count` field of the response.\n\nThe default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the total count of customers in the `count` field of the response.\n\nThe default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareOnlineSites.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareOnlineSites.json new file mode 100644 index 00000000..4c36985d --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSquareOnlineSites.json @@ -0,0 +1,71 @@ +{ + "name": "ListSquareOnlineSites", + "fully_qualified_name": "SquareupApi.ListSquareOnlineSites@0.1.0", + "description": "Retrieve a list of Square Online sites for a seller.\n\nUse this tool to obtain a list of Square Online sites associated with a seller, ordered by their creation date. This is part of Square's early access program for online APIs.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'ListSites'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ONLINE_STORE_SITE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/sites", + "http_method": "GET", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSubscriptionEvents.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSubscriptionEvents.json new file mode 100644 index 00000000..aa7c6062 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListSubscriptionEvents.json @@ -0,0 +1,169 @@ +{ + "name": "ListSubscriptionEvents", + "fully_qualified_name": "SquareupApi.ListSubscriptionEvents@0.1.0", + "description": "Retrieve events for a specific subscription.\n\nCall this tool to retrieve all events related to a specific subscription using the Square API. Useful for tracking changes and updates within a subscription lifecycle.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "subscription_id", + "required": true, + "description": "The unique ID of the subscription to retrieve events for. Use this to specify which subscription's events to list.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription to retrieve the events for." + }, + "inferrable": true, + "http_endpoint_parameter_name": "subscription_id" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "Specify the cursor to fetch the next set of subscription events if results exceed the limit. Leave unset for the last page.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "When the total number of resulting subscription events exceeds the limit of a paged response, \nspecify the cursor returned from a preceding response here to fetch the next set of results.\nIf the cursor is unset, the response contains the last page of the results.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "max_events_per_page", + "required": false, + "description": "The maximum number of subscription events to return in a single response page.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The upper limit on the number of subscription events to return\nin a paged response." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListSubscriptionEvents'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "SUBSCRIPTIONS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/subscriptions/{subscription_id}/events", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "When the total number of resulting subscription events exceeds the limit of a paged response, \nspecify the cursor returned from a preceding response here to fetch the next set of results.\nIf the cursor is unset, the response contains the last page of the results.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "When the total number of resulting subscription events exceeds the limit of a paged response, \nspecify the cursor returned from a preceding response here to fetch the next set of results.\nIf the cursor is unset, the response contains the last page of the results.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_events_per_page", + "description": "The upper limit on the number of subscription events to return\nin a paged response.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The upper limit on the number of subscription events to return\nin a paged response." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "subscription_id", + "tool_parameter_name": "subscription_id", + "description": "The ID of the subscription to retrieve the events for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription to retrieve the events for." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberBookingProfiles.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberBookingProfiles.json new file mode 100644 index 00000000..e0bb16da --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberBookingProfiles.json @@ -0,0 +1,201 @@ +{ + "name": "ListTeamMemberBookingProfiles", + "fully_qualified_name": "SquareupApi.ListTeamMemberBookingProfiles@0.1.0", + "description": "Lists booking profiles for team members.\n\nCall this tool to retrieve booking profiles for all team members, useful for managing schedules and appointments.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "max_results_per_page", + "required": false, + "description": "The maximum number of results to return in a paged response. Useful for controlling pagination size.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a paged response." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "The pagination cursor for returning the next page of results. Leave empty to get the first page.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "filter_by_location_id", + "required": false, + "description": "Specify the location ID to filter team members enabled at that location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to include only team members enabled at the given location in the returned result." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "include_only_bookable_team_members", + "required": false, + "description": "Set to true to include only bookable team members in the result; false to include all members.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "bookable_only" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListTeamMemberBookingProfiles'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_BUSINESS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/team-member-booking-profiles", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "bookable_only", + "tool_parameter_name": "include_only_bookable_team_members", + "description": "Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`).", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to return in a paged response.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to return in a paged response." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The pagination cursor from the preceding response to return the next page of the results. Do not set this when retrieving the first page of the results." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "location_id", + "tool_parameter_name": "filter_by_location_id", + "description": "Indicates whether to include only team members enabled at the given location in the returned result.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to include only team members enabled at the given location in the returned result." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberWages.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberWages.json new file mode 100644 index 00000000..ab7172fb --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListTeamMemberWages.json @@ -0,0 +1,169 @@ +{ + "name": "ListTeamMemberWages", + "fully_qualified_name": "SquareupApi.ListTeamMemberWages@0.1.0", + "description": "Retrieve paginated team member wages for a business.\n\nUse this tool to obtain a paginated list of wages for team members within a business. Ideal for managing payroll and financial records.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "filter_by_team_member_id", + "required": false, + "description": "Filter wages by specifying the team member's ID. Only wages for this team member will be returned.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Filter the returned wages to only those that are associated with the\nspecified team member." + }, + "inferrable": true, + "http_endpoint_parameter_name": "team_member_id" + }, + { + "name": "results_per_page", + "required": false, + "description": "Specifies the maximum number of team member wages to return per page, ranging from 1 to 200. Default is 200.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of `TeamMemberWage` results to return per page. The number can range between\n1 and 200. The default is 200." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "next_page_cursor", + "required": false, + "description": "A token used to fetch the next page of team member wage results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pointer to the next page of `EmployeeWage` results to fetch." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListTeamMemberWages'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "EMPLOYEES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/team-member-wages", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "team_member_id", + "tool_parameter_name": "filter_by_team_member_id", + "description": "Filter the returned wages to only those that are associated with the\nspecified team member.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Filter the returned wages to only those that are associated with the\nspecified team member." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "results_per_page", + "description": "The maximum number of `TeamMemberWage` results to return per page. The number can range between\n1 and 200. The default is 200.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of `TeamMemberWage` results to return per page. The number can range between\n1 and 200. The default is 200." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "next_page_cursor", + "description": "A pointer to the next page of `EmployeeWage` results to fetch.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pointer to the next page of `EmployeeWage` results to fetch." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookEventTypes.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookEventTypes.json new file mode 100644 index 00000000..4ab39d03 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookEventTypes.json @@ -0,0 +1,101 @@ +{ + "name": "ListWebhookEventTypes", + "fully_qualified_name": "SquareupApi.ListWebhookEventTypes@0.1.0", + "description": "Retrieves all available webhook event types for subscription.\n\nUse this tool to get a comprehensive list of webhook event types that can be subscribed to via the Square API.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "api_version", + "required": false, + "description": "Specify the API version to list event types. Overrides the default version if set.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The API version for which to list event types. Setting this field overrides the default version used by the application." + }, + "inferrable": true, + "http_endpoint_parameter_name": "api_version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListWebhookEventTypes'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/webhooks/event-types", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "api_version", + "tool_parameter_name": "api_version", + "description": "The API version for which to list event types. Setting this field overrides the default version used by the application.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The API version for which to list event types. Setting this field overrides the default version used by the application." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookSubscriptions.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookSubscriptions.json new file mode 100644 index 00000000..ba42fe10 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWebhookSubscriptions.json @@ -0,0 +1,203 @@ +{ + "name": "ListWebhookSubscriptions", + "fully_qualified_name": "SquareupApi.ListWebhookSubscriptions@0.1.0", + "description": "Lists all webhook subscriptions for your application.\n\nUse this tool to retrieve a list of all webhook subscriptions owned by your application. It is useful for managing or reviewing your webhook configurations.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A cursor for pagination to retrieve the next set of results from a previous query.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "sort_order", + "required": false, + "description": "Sorts the webhook subscriptions by creation date. Options are 'ASC' for ascending or 'DESC' for descending. Defaults to 'ASC'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "Sorts the returned list by when the [Subscription](entity:WebhookSubscription) was created with the specified order.\nThis field defaults to ASC." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "max_results_per_page", + "required": false, + "description": "The maximum number of webhook subscription results to return in a single page (max: 100).", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value.\n\nDefault: 100" + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "include_disabled_subscriptions", + "required": false, + "description": "Set to true to include disabled subscriptions in the results. By default, only enabled subscriptions are returned.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Includes disabled [Subscription](entity:WebhookSubscription)s.\nBy default, all enabled [Subscription](entity:WebhookSubscription)s are returned." + }, + "inferrable": true, + "http_endpoint_parameter_name": "include_disabled" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListWebhookSubscriptions'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/webhooks/subscriptions", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination)." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "include_disabled", + "tool_parameter_name": "include_disabled_subscriptions", + "description": "Includes disabled [Subscription](entity:WebhookSubscription)s.\nBy default, all enabled [Subscription](entity:WebhookSubscription)s are returned.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Includes disabled [Subscription](entity:WebhookSubscription)s.\nBy default, all enabled [Subscription](entity:WebhookSubscription)s are returned." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "sort_order", + "description": "Sorts the returned list by when the [Subscription](entity:WebhookSubscription) was created with the specified order.\nThis field defaults to ASC.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "Sorts the returned list by when the [Subscription](entity:WebhookSubscription) was created with the specified order.\nThis field defaults to ASC." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value.\n\nDefault: 100", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of results to be returned in a single page.\nIt is possible to receive fewer results than the specified limit on a given page.\nThe default value of 100 is also the maximum allowed value.\n\nDefault: 100" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWorkweekConfigurations.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWorkweekConfigurations.json new file mode 100644 index 00000000..fb21960a --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/ListWorkweekConfigurations.json @@ -0,0 +1,137 @@ +{ + "name": "ListWorkweekConfigurations", + "fully_qualified_name": "SquareupApi.ListWorkweekConfigurations@0.1.0", + "description": "Retrieve workweek configurations for a business.\n\nThis tool returns a list of workweek configuration instances, providing details about the workweek setup for a specified business. It should be used when you need to understand or analyze the workweek parameters configured within a business.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "max_results_per_page", + "required": false, + "description": "The maximum number of workweek configurations to return per page.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of `WorkweekConfigs` results to return per page." + }, + "inferrable": true, + "http_endpoint_parameter_name": "limit" + }, + { + "name": "page_cursor", + "required": false, + "description": "A string that acts as a pointer to fetch the next page of workweek configuration results.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pointer to the next page of `WorkweekConfig` results to fetch." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListWorkweekConfigs'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "TIMECARDS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/workweek-configs", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "limit", + "tool_parameter_name": "max_results_per_page", + "description": "The maximum number of `WorkweekConfigs` results to return per page.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The maximum number of `WorkweekConfigs` results to return per page." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "page_cursor", + "description": "A pointer to the next page of `WorkweekConfig` results to fetch.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pointer to the next page of `WorkweekConfig` results to fetch." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveDisputeEvidence.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveDisputeEvidence.json new file mode 100644 index 00000000..4d826a58 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveDisputeEvidence.json @@ -0,0 +1,137 @@ +{ + "name": "RemoveDisputeEvidence", + "fully_qualified_name": "SquareupApi.RemoveDisputeEvidence@0.1.0", + "description": "Removes specified evidence from a dispute.\n\nUse this tool to remove evidence from a dispute. This can be called when it's necessary to retract evidence previously submitted for a dispute. The bank will not be informed of the removed evidence.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "dispute_id", + "required": true, + "description": "The unique identifier of the dispute from which evidence should be removed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute from which you want to remove evidence." + }, + "inferrable": true, + "http_endpoint_parameter_name": "dispute_id" + }, + { + "name": "evidence_id_to_remove", + "required": true, + "description": "The ID of the evidence you want to remove from the dispute.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the evidence you want to remove." + }, + "inferrable": true, + "http_endpoint_parameter_name": "evidence_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteDisputeEvidence'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DISPUTES_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/disputes/{dispute_id}/evidence/{evidence_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "dispute_id", + "tool_parameter_name": "dispute_id", + "description": "The ID of the dispute from which you want to remove evidence.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute from which you want to remove evidence." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "evidence_id", + "tool_parameter_name": "evidence_id_to_remove", + "description": "The ID of the evidence you want to remove.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the evidence you want to remove." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveGroupFromCustomer.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveGroupFromCustomer.json new file mode 100644 index 00000000..9fa6fc87 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveGroupFromCustomer.json @@ -0,0 +1,137 @@ +{ + "name": "RemoveGroupFromCustomer", + "fully_qualified_name": "SquareupApi.RemoveGroupFromCustomer@0.1.0", + "description": "Removes a group membership from a customer.\n\nUse this tool to remove a customer's membership in a specific group by providing the customer's ID and the group's ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_id", + "required": true, + "description": "The unique ID of the customer to remove from the specified group. Provide as a string.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to remove from the group." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "customer_group_id", + "required": true, + "description": "The ID of the customer group from which the customer will be removed.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to remove the customer from." + }, + "inferrable": true, + "http_endpoint_parameter_name": "group_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RemoveGroupFromCustomer'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/{customer_id}/groups/{group_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "customer_id", + "tool_parameter_name": "customer_id", + "description": "The ID of the customer to remove from the group.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer to remove from the group." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "group_id", + "tool_parameter_name": "customer_group_id", + "description": "The ID of the customer group to remove the customer from.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to remove the customer from." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveInvoiceAttachment.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveInvoiceAttachment.json new file mode 100644 index 00000000..17b8edbe --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveInvoiceAttachment.json @@ -0,0 +1,137 @@ +{ + "name": "RemoveInvoiceAttachment", + "fully_qualified_name": "SquareupApi.RemoveInvoiceAttachment@0.1.0", + "description": "Remove an attachment from an invoice and delete the file.\n\nUse this tool to permanently delete an attachment from an invoice. It is applicable only for invoices in the DRAFT, SCHEDULED, UNPAID, or PARTIALLY_PAID state.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "invoice_id", + "required": true, + "description": "The unique identifier of the invoice to remove the attachment from. Applicable for invoices in specific states (DRAFT, SCHEDULED, UNPAID, PARTIALLY_PAID).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [invoice](entity:Invoice) to delete the attachment from." + }, + "inferrable": true, + "http_endpoint_parameter_name": "invoice_id" + }, + { + "name": "attachment_id", + "required": true, + "description": "The unique identifier of the attachment to delete from the invoice. It should be a string corresponding to the attachment's ID.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [attachment](entity:InvoiceAttachment) to delete." + }, + "inferrable": true, + "http_endpoint_parameter_name": "attachment_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteInvoiceAttachment'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "INVOICES_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/invoices/{invoice_id}/attachments/{attachment_id}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "invoice_id", + "tool_parameter_name": "invoice_id", + "description": "The ID of the [invoice](entity:Invoice) to delete the attachment from.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [invoice](entity:Invoice) to delete the attachment from." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "attachment_id", + "tool_parameter_name": "attachment_id", + "description": "The ID of the [attachment](entity:InvoiceAttachment) to delete.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [attachment](entity:InvoiceAttachment) to delete." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveLocationCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveLocationCustomAttribute.json new file mode 100644 index 00000000..6f1a6ae6 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveLocationCustomAttribute.json @@ -0,0 +1,137 @@ +{ + "name": "RemoveLocationCustomAttribute", + "fully_qualified_name": "SquareupApi.RemoveLocationCustomAttribute@0.1.0", + "description": "Deletes a custom attribute from a specified location.\n\nUse this tool to delete a custom attribute associated with a specified location. Ensure that the attribute's visibility is set to `VISIBILITY_READ_WRITE_VALUES` if it is owned by another application.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": true, + "description": "The ID of the target location for which the custom attribute will be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [location](entity:Location)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key for the custom attribute to delete. Use the qualified key if not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteLocationCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations/{location_id}/custom-attributes/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the target [location](entity:Location).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [location](entity:Location)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveMerchantCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveMerchantCustomAttribute.json new file mode 100644 index 00000000..0c80d12f --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveMerchantCustomAttribute.json @@ -0,0 +1,137 @@ +{ + "name": "RemoveMerchantCustomAttribute", + "fully_qualified_name": "SquareupApi.RemoveMerchantCustomAttribute@0.1.0", + "description": "Deletes a custom attribute from a merchant.\n\nUse this tool to delete a custom attribute associated with a merchant. The attribute can only be deleted if its visibility is set to 'VISIBILITY_READ_WRITE_VALUES' if owned by another application.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "merchant_identifier", + "required": true, + "description": "The unique identifier of the target merchant whose custom attribute will be deleted.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [merchant](entity:Merchant)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "merchant_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute to delete. It must match a custom attribute definition in the Square seller account. Use a qualified key if not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteMerchantCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants/{merchant_id}/custom-attributes/{key}", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "merchant_id", + "tool_parameter_name": "merchant_identifier", + "description": "The ID of the target [merchant](entity:Merchant).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [merchant](entity:Merchant)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to delete. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveSquareOnlineSnippet.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveSquareOnlineSnippet.json new file mode 100644 index 00000000..2061d28e --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RemoveSquareOnlineSnippet.json @@ -0,0 +1,105 @@ +{ + "name": "RemoveSquareOnlineSnippet", + "fully_qualified_name": "SquareupApi.RemoveSquareOnlineSnippet@0.1.0", + "description": "Delete a snippet from a Square Online site.\n\nUse this tool to remove a snippet from a Square Online site. Call it when you have the site ID from which you want to delete the snippet. Ideal for managing online site content efficiently.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "site_id_for_snippet_removal", + "required": true, + "description": "The unique ID of the Square Online site containing the snippet to remove.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the site that contains the snippet." + }, + "inferrable": true, + "http_endpoint_parameter_name": "site_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'DeleteSnippet'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ONLINE_STORE_SNIPPETS_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/sites/{site_id}/snippet", + "http_method": "DELETE", + "headers": {}, + "parameters": [ + { + "name": "site_id", + "tool_parameter_name": "site_id_for_snippet_removal", + "description": "The ID of the site that contains the snippet.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the site that contains the snippet." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBooking.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBooking.json new file mode 100644 index 00000000..76f45938 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBooking.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveBooking", + "fully_qualified_name": "SquareupApi.RetrieveBooking@0.1.0", + "description": "Retrieve details of a specific booking.\n\nUse this tool to get information about a particular booking using its ID. Appropriate OAuth scopes are required depending on whether buyer or seller permissions are needed.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "booking_id", + "required": true, + "description": "The unique identifier for the booking to retrieve details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [Booking](entity:Booking) object representing the to-be-retrieved booking." + }, + "inferrable": true, + "http_endpoint_parameter_name": "booking_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveBooking'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/{booking_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "booking_id", + "tool_parameter_name": "booking_id", + "description": "The ID of the [Booking](entity:Booking) object representing the to-be-retrieved booking.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [Booking](entity:Booking) object representing the to-be-retrieved booking." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBookingCustomAttributeDefinition.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBookingCustomAttributeDefinition.json new file mode 100644 index 00000000..914232e0 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBookingCustomAttributeDefinition.json @@ -0,0 +1,137 @@ +{ + "name": "RetrieveBookingCustomAttributeDefinition", + "fully_qualified_name": "SquareupApi.RetrieveBookingCustomAttributeDefinition@0.1.0", + "description": "Retrieve a booking's custom attribute definition.\n\nUse this tool to obtain the definition of a custom attribute for bookings. Appropriate OAuth scope permissions are required, either buyer-level (`APPOINTMENTS_READ`) or seller-level (`APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ`).", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute definition to retrieve. If not the definition owner, use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_version", + "required": false, + "description": "The version of the custom attribute definition for consistent reads. If the version is too high, a `BAD_REQUEST` error occurs.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveBookingCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/custom-attribute-definitions/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "custom_attribute_version", + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBreakType.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBreakType.json new file mode 100644 index 00000000..0ac38c3f --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveBreakType.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveBreakType", + "fully_qualified_name": "SquareupApi.RetrieveBreakType@0.1.0", + "description": "Retrieve details of a specific break type by ID.\n\nUse this tool to obtain information about a specific break type using its unique identifier.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "break_type_id", + "required": true, + "description": "The unique identifier (UUID) for the BreakType to be retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `BreakType` being retrieved." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetBreakType'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "TIMECARDS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/break-types/{id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "break_type_id", + "description": "The UUID for the `BreakType` being retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `BreakType` being retrieved." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardDetails.json new file mode 100644 index 00000000..86c0767a --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardDetails.json @@ -0,0 +1,101 @@ +{ + "name": "RetrieveCardDetails", + "fully_qualified_name": "SquareupApi.RetrieveCardDetails@0.1.0", + "description": "Retrieve details for a specific card using its ID.\n\nThis tool retrieves information about a specific card identified by its ID, allowing users to access details such as metadata and status.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "card_identifier", + "required": true, + "description": "Unique ID for the card to retrieve its details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired Card." + }, + "inferrable": true, + "http_endpoint_parameter_name": "card_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCard'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/cards/{card_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "card_id", + "tool_parameter_name": "card_identifier", + "description": "Unique ID for the desired Card.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Unique ID for the desired Card." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardList.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardList.json new file mode 100644 index 00000000..45ef53c2 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCardList.json @@ -0,0 +1,235 @@ +{ + "name": "RetrieveCardList", + "fully_qualified_name": "SquareupApi.RetrieveCardList@0.1.0", + "description": "Retrieve a list of cards owned by the account.\n\nThe tool retrieves up to 25 cards associated with the account making the request. It should be used when there is a need to access card information for the account.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "pagination_cursor", + "required": false, + "description": "A string value representing a pagination cursor to retrieve the next set of results. Use this to continue from the last retrieved set.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + }, + { + "name": "filter_by_customer_id", + "required": false, + "description": "Limit results to cards associated with the specified customer. By default, all merchant-owned cards are returned.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to cards associated with the customer supplied.\nBy default, all cards owned by the merchant are returned." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "filter_by_reference_id", + "required": false, + "description": "Filter results to include only cards associated with the specified reference ID.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to cards associated with the reference_id supplied." + }, + "inferrable": true, + "http_endpoint_parameter_name": "reference_id" + }, + { + "name": "card_sort_order", + "required": false, + "description": "Defines the sort order for the card creation date. Use 'ASC' for ascending or 'DESC' for descending. Defaults to 'ASC'.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "Sorts the returned list by when the card was created with the specified order.\nThis field defaults to ASC." + }, + "inferrable": true, + "http_endpoint_parameter_name": "sort_order" + }, + { + "name": "include_disabled_cards", + "required": false, + "description": "Set to true to include disabled cards in the results. By default, only enabled cards are returned.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Includes disabled cards.\nBy default, all enabled cards owned by the merchant are returned." + }, + "inferrable": true, + "http_endpoint_parameter_name": "include_disabled" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'ListCards'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/cards", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "customer_id", + "tool_parameter_name": "filter_by_customer_id", + "description": "Limit results to cards associated with the customer supplied.\nBy default, all cards owned by the merchant are returned.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to cards associated with the customer supplied.\nBy default, all cards owned by the merchant are returned." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "include_disabled", + "tool_parameter_name": "include_disabled_cards", + "description": "Includes disabled cards.\nBy default, all enabled cards owned by the merchant are returned.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Includes disabled cards.\nBy default, all enabled cards owned by the merchant are returned." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "reference_id", + "tool_parameter_name": "filter_by_reference_id", + "description": "Limit results to cards associated with the reference_id supplied.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Limit results to cards associated with the reference_id supplied." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "sort_order", + "tool_parameter_name": "card_sort_order", + "description": "Sorts the returned list by when the card was created with the specified order.\nThis field defaults to ASC.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": [ + "DESC", + "ASC" + ], + "properties": null, + "inner_properties": null, + "description": "Sorts the returned list by when the card was created with the specified order.\nThis field defaults to ASC." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogInfo.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogInfo.json new file mode 100644 index 00000000..cd92365d --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogInfo.json @@ -0,0 +1,71 @@ +{ + "name": "RetrieveCatalogInfo", + "fully_qualified_name": "SquareupApi.RetrieveCatalogInfo@0.1.0", + "description": "Retrieve Square Catalog API details and batch size limits.\n\nUse this tool to get information about the Square Catalog API, including batch size limits for catalog operations.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'CatalogInfo'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ITEMS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/catalog/info", + "http_method": "GET", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogItem.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogItem.json new file mode 100644 index 00000000..52720bad --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCatalogItem.json @@ -0,0 +1,201 @@ +{ + "name": "RetrieveCatalogItem", + "fully_qualified_name": "SquareupApi.RetrieveCatalogItem@0.1.0", + "description": "Fetch detailed catalog item information by ID.\n\nUse this tool to obtain complete details about a specific catalog item, including its variations, modifier lists, and applicable taxes, by providing the item ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "catalog_object_id", + "required": true, + "description": "The ID of the catalog object to retrieve. Use a unique string to specify the object.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The object ID of any type of catalog objects to be retrieved." + }, + "inferrable": true, + "http_endpoint_parameter_name": "object_id" + }, + { + "name": "catalog_version", + "required": false, + "description": "Specify the version number of the catalog to retrieve objects from a specific historical catalog version. If omitted, retrieves the current version.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Requests objects as of a specific version of the catalog. This allows you to retrieve historical\nversions of objects. The value to retrieve a specific version of an object can be found\nin the version field of [CatalogObject](entity:CatalogObject)s. If not included, results will\nbe from the current version of the catalog." + }, + "inferrable": true, + "http_endpoint_parameter_name": "catalog_version" + }, + { + "name": "include_related_objects", + "required": false, + "description": "Include additional objects related to the requested items in the response if set to `true`. This helps in displaying complete information for immediate use.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If `true`, the response will include additional objects that are related to the\nrequested objects. Related objects are defined as any objects referenced by ID by the results in the `objects` field\nof the response. These objects are put in the `related_objects` field. Setting this to `true` is\nhelpful when the objects are needed for immediate display to a user.\nThis process only goes one level deep. Objects referenced by the related objects will not be included. For example,\n\nif the `objects` field of the response contains a CatalogItem, its associated\nCatalogCategory objects, CatalogTax objects, CatalogImage objects and\nCatalogModifierLists will be returned in the `related_objects` field of the\nresponse. If the `objects` field of the response contains a CatalogItemVariation,\nits parent CatalogItem will be returned in the `related_objects` field of\nthe response.\n\nDefault value: `false`" + }, + "inferrable": true, + "http_endpoint_parameter_name": "include_related_objects" + }, + { + "name": "include_category_path_to_root", + "required": false, + "description": "Set to 'true' to include the `path_to_root` list for each returned category instance. This path starts with the immediate parent category and ends with the root category. If the category is top-level, the `path_to_root` list is empty and not returned.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Specifies whether or not to include the `path_to_root` list for each returned category instance. The `path_to_root` list consists\nof `CategoryPathToRootNode` objects and specifies the path that starts with the immediate parent category of the returned category\nand ends with its root category. If the returned category is a top-level category, the `path_to_root` list is empty and is not returned\nin the response payload." + }, + "inferrable": true, + "http_endpoint_parameter_name": "include_category_path_to_root" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCatalogObject'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ITEMS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/catalog/object/{object_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "include_related_objects", + "tool_parameter_name": "include_related_objects", + "description": "If `true`, the response will include additional objects that are related to the\nrequested objects. Related objects are defined as any objects referenced by ID by the results in the `objects` field\nof the response. These objects are put in the `related_objects` field. Setting this to `true` is\nhelpful when the objects are needed for immediate display to a user.\nThis process only goes one level deep. Objects referenced by the related objects will not be included. For example,\n\nif the `objects` field of the response contains a CatalogItem, its associated\nCatalogCategory objects, CatalogTax objects, CatalogImage objects and\nCatalogModifierLists will be returned in the `related_objects` field of the\nresponse. If the `objects` field of the response contains a CatalogItemVariation,\nits parent CatalogItem will be returned in the `related_objects` field of\nthe response.\n\nDefault value: `false`", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "If `true`, the response will include additional objects that are related to the\nrequested objects. Related objects are defined as any objects referenced by ID by the results in the `objects` field\nof the response. These objects are put in the `related_objects` field. Setting this to `true` is\nhelpful when the objects are needed for immediate display to a user.\nThis process only goes one level deep. Objects referenced by the related objects will not be included. For example,\n\nif the `objects` field of the response contains a CatalogItem, its associated\nCatalogCategory objects, CatalogTax objects, CatalogImage objects and\nCatalogModifierLists will be returned in the `related_objects` field of the\nresponse. If the `objects` field of the response contains a CatalogItemVariation,\nits parent CatalogItem will be returned in the `related_objects` field of\nthe response.\n\nDefault value: `false`" + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "catalog_version", + "tool_parameter_name": "catalog_version", + "description": "Requests objects as of a specific version of the catalog. This allows you to retrieve historical\nversions of objects. The value to retrieve a specific version of an object can be found\nin the version field of [CatalogObject](entity:CatalogObject)s. If not included, results will\nbe from the current version of the catalog.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Requests objects as of a specific version of the catalog. This allows you to retrieve historical\nversions of objects. The value to retrieve a specific version of an object can be found\nin the version field of [CatalogObject](entity:CatalogObject)s. If not included, results will\nbe from the current version of the catalog." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "include_category_path_to_root", + "tool_parameter_name": "include_category_path_to_root", + "description": "Specifies whether or not to include the `path_to_root` list for each returned category instance. The `path_to_root` list consists\nof `CategoryPathToRootNode` objects and specifies the path that starts with the immediate parent category of the returned category\nand ends with its root category. If the returned category is a top-level category, the `path_to_root` list is empty and is not returned\nin the response payload.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Specifies whether or not to include the `path_to_root` list for each returned category instance. The `path_to_root` list consists\nof `CategoryPathToRootNode` objects and specifies the path that starts with the immediate parent category of the returned category\nand ends with its root category. If the returned category is a top-level category, the `path_to_root` list is empty and is not returned\nin the response payload." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "object_id", + "tool_parameter_name": "catalog_object_id", + "description": "The object ID of any type of catalog objects to be retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The object ID of any type of catalog objects to be retrieved." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCheckoutLocationSettings.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCheckoutLocationSettings.json new file mode 100644 index 00000000..1811cb0d --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCheckoutLocationSettings.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveCheckoutLocationSettings", + "fully_qualified_name": "SquareupApi.RetrieveCheckoutLocationSettings@0.1.0", + "description": "Retrieve location-level settings for a Square checkout page.\n\nFetches the settings for a specified location's Square-hosted checkout page. Useful for accessing configuration details or customizing checkout experiences based on location.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": true, + "description": "The unique identifier for the location to retrieve settings for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to retrieve settings." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLocationSettings'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/online-checkout/location-settings/{location_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the location for which to retrieve settings.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location for which to retrieve settings." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerCustomAttribute.json new file mode 100644 index 00000000..1139ece5 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerCustomAttribute.json @@ -0,0 +1,201 @@ +{ + "name": "RetrieveCustomerCustomAttribute", + "fully_qualified_name": "SquareupApi.RetrieveCustomerCustomAttribute@0.1.0", + "description": "Retrieve a custom attribute for a customer profile.\n\nUse this tool to get a custom attribute associated with a customer. Optionally, retrieve the attribute definition and ensure proper visibility settings for attributes owned by other applications.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_profile_id", + "required": true, + "description": "The ID of the target customer profile you want to retrieve a custom attribute for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [customer profile](entity:Customer)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "customer_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The unique key of the custom attribute to retrieve, matching the definition in the Square seller account. Use the qualified key if the app is not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_version", + "required": false, + "description": "The current version of the custom attribute for consistent reads. If higher than available, returns an error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + }, + { + "name": "include_custom_attribute_definition", + "required": false, + "description": "Set to true to include the custom attribute definition in the response, including details like name, description, and data type.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definition" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCustomerCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/{customer_id}/custom-attributes/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "with_definition", + "tool_parameter_name": "include_custom_attribute_definition", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of\nthe custom attribute. Set this parameter to `true` to get the name and description of the custom\nattribute, information about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "version", + "tool_parameter_name": "custom_attribute_version", + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute, which is used for strongly consistent reads to\nguarantee that you receive the most up-to-date data. When included in the request, Square\nreturns the specified version or a higher version if one exists. If the specified version is\nhigher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "customer_id", + "tool_parameter_name": "customer_profile_id", + "description": "The ID of the target [customer profile](entity:Customer).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [customer profile](entity:Customer)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the `key` of a custom\nattribute definition in the Square seller account. If the requesting application is not the\ndefinition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerGroup.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerGroup.json new file mode 100644 index 00000000..05f4c2f4 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerGroup.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveCustomerGroup", + "fully_qualified_name": "SquareupApi.RetrieveCustomerGroup@0.1.0", + "description": "Retrieve details of a specific customer group using its ID.\n\nThis tool retrieves information about a specific customer group identified by a given group ID. It is useful for accessing details about customer segmentation for targeting or analysis purposes.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_group_id", + "required": true, + "description": "The ID of the customer group you want to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "group_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCustomerGroup'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/groups/{group_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "group_id", + "tool_parameter_name": "customer_group_id", + "description": "The ID of the customer group to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the customer group to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerSegment.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerSegment.json new file mode 100644 index 00000000..76cf1a08 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveCustomerSegment.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveCustomerSegment", + "fully_qualified_name": "SquareupApi.RetrieveCustomerSegment@0.1.0", + "description": "Retrieve details of a specific customer segment.\n\nUse this tool to obtain information about a customer segment identified by a `segment_id`.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "customer_segment_id", + "required": true, + "description": "The Square-issued ID of the customer segment to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The Square-issued ID of the customer segment." + }, + "inferrable": true, + "http_endpoint_parameter_name": "segment_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveCustomerSegment'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "CUSTOMERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/customers/segments/{segment_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "segment_id", + "tool_parameter_name": "customer_segment_id", + "description": "The Square-issued ID of the customer segment.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The Square-issued ID of the customer segment." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceCode.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceCode.json new file mode 100644 index 00000000..546f37c4 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceCode.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveDeviceCode", + "fully_qualified_name": "SquareupApi.RetrieveDeviceCode@0.1.0", + "description": "Retrieve device code details by ID.\n\nUse this tool to get details of a device code using the associated ID from Squareup.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "device_code_id", + "required": true, + "description": "The unique identifier for the device code to retrieve details from Squareup.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique identifier for the device code." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetDeviceCode'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DEVICE_CREDENTIAL_MANAGEMENT" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/devices/codes/{id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "device_code_id", + "description": "The unique identifier for the device code.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique identifier for the device code." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceInfo.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceInfo.json new file mode 100644 index 00000000..dfd860d3 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDeviceInfo.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveDeviceInfo", + "fully_qualified_name": "SquareupApi.RetrieveDeviceInfo@0.1.0", + "description": "Retrieve device information using a device ID.\n\nUse this tool to obtain details about a specific device by providing its device ID. It retrieves information related to the device, which can be useful for managing or reviewing devices in a system.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "device_unique_id", + "required": true, + "description": "The unique identifier for the device you want to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `Device`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "device_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetDevice'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DEVICES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/devices/{device_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "device_id", + "tool_parameter_name": "device_unique_id", + "description": "The unique ID for the desired `Device`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `Device`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDisputeDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDisputeDetails.json new file mode 100644 index 00000000..328aa1ab --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveDisputeDetails.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveDisputeDetails", + "fully_qualified_name": "SquareupApi.RetrieveDisputeDetails@0.1.0", + "description": "Retrieve details about a specific dispute.\n\nUse this tool to get detailed information about a particular dispute, including the reasons and status of the dispute.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "dispute_id", + "required": true, + "description": "The unique ID of the dispute to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute you want more details about." + }, + "inferrable": true, + "http_endpoint_parameter_name": "dispute_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveDispute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DISPUTES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/disputes/{dispute_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "dispute_id", + "tool_parameter_name": "dispute_id", + "description": "The ID of the dispute you want more details about.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute you want more details about." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryCount.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryCount.json new file mode 100644 index 00000000..2c4e18c1 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryCount.json @@ -0,0 +1,169 @@ +{ + "name": "RetrieveInventoryCount", + "fully_qualified_name": "SquareupApi.RetrieveInventoryCount@0.1.0", + "description": "Get the current stock count for an item.\n\nFetches the current calculated stock level for a specific CatalogObject at specified Locations. Useful for checking inventory availability. Results are paginated and unsorted.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "catalog_object_id", + "required": true, + "description": "ID of the CatalogObject to retrieve the inventory count for. Required for specifying which item to query.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [CatalogObject](entity:CatalogObject) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "catalog_object_id" + }, + { + "name": "location_ids", + "required": false, + "description": "Comma-separated list of Location IDs to query. Use empty to query all locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_ids" + }, + { + "name": "pagination_cursor", + "required": false, + "description": "A pagination cursor to retrieve the next set of results for an ongoing query.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for the original query.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information." + }, + "inferrable": true, + "http_endpoint_parameter_name": "cursor" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveInventoryCount'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "INVENTORY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/inventory/{catalog_object_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_ids", + "tool_parameter_name": "location_ids", + "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "cursor", + "tool_parameter_name": "pagination_cursor", + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for the original query.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for the original query.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "catalog_object_id", + "tool_parameter_name": "catalog_object_id", + "description": "ID of the [CatalogObject](entity:CatalogObject) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [CatalogObject](entity:CatalogObject) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryPhysicalCount.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryPhysicalCount.json new file mode 100644 index 00000000..d4dcb982 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInventoryPhysicalCount.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveInventoryPhysicalCount", + "fully_qualified_name": "SquareupApi.RetrieveInventoryPhysicalCount@0.1.0", + "description": "Retrieve the inventory physical count by its ID.\n\nCall this tool to obtain information about a specific inventory physical count using the provided `physical_count_id`. It returns the associated InventoryPhysicalCount object.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "inventory_physical_count_id", + "required": true, + "description": "ID of the InventoryPhysicalCount to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the\n[InventoryPhysicalCount](entity:InventoryPhysicalCount) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "physical_count_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveInventoryPhysicalCount'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "INVENTORY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/inventory/physical-counts/{physical_count_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "physical_count_id", + "tool_parameter_name": "inventory_physical_count_id", + "description": "ID of the\n[InventoryPhysicalCount](entity:InventoryPhysicalCount) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the\n[InventoryPhysicalCount](entity:InventoryPhysicalCount) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInvoiceById.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInvoiceById.json new file mode 100644 index 00000000..ab447629 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveInvoiceById.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveInvoiceById", + "fully_qualified_name": "SquareupApi.RetrieveInvoiceById@0.1.0", + "description": "Retrieve details of an invoice using its ID.\n\nUse this tool to obtain detailed information about a specific invoice by providing its unique ID. It is useful for accessing invoice data such as amounts, status, and recipient information.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "invoice_id", + "required": true, + "description": "The unique ID of the invoice to retrieve information for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the invoice to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "invoice_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetInvoice'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "INVOICES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/invoices/{invoice_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "invoice_id", + "tool_parameter_name": "invoice_id", + "description": "The ID of the invoice to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the invoice to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveJobDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveJobDetails.json new file mode 100644 index 00000000..377fcc3d --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveJobDetails.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveJobDetails", + "fully_qualified_name": "SquareupApi.RetrieveJobDetails@0.1.0", + "description": "Retrieve details of a specified job by ID.\n\nUse this tool to get information about a specific job using its ID. It should be called when details about a particular job are needed, such as in management and administrative tasks.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "job_identifier", + "required": true, + "description": "The unique ID of the job to retrieve. This is required to fetch the job details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the job to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "job_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveJob'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "EMPLOYEES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/team-members/jobs/{job_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "job_id", + "tool_parameter_name": "job_identifier", + "description": "The ID of the job to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the job to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationBookingProfile.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationBookingProfile.json new file mode 100644 index 00000000..a286d473 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationBookingProfile.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveLocationBookingProfile", + "fully_qualified_name": "SquareupApi.RetrieveLocationBookingProfile@0.1.0", + "description": "Retrieve a seller's location booking profile.\n\nUse this tool to obtain the booking profile details for a specific seller's location by providing the location ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": true, + "description": "The unique ID of the location whose booking profile is to be retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to retrieve the booking profile." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLocationBookingProfile'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_BUSINESS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/location-booking-profiles/{location_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the location to retrieve the booking profile.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to retrieve the booking profile." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationCustomAttributeDefinition.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationCustomAttributeDefinition.json new file mode 100644 index 00000000..f9c49ed9 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationCustomAttributeDefinition.json @@ -0,0 +1,137 @@ +{ + "name": "RetrieveLocationCustomAttributeDefinition", + "fully_qualified_name": "SquareupApi.RetrieveLocationCustomAttributeDefinition@0.1.0", + "description": "Retrieve location-related custom attribute definitions.\n\nRetrieves a custom attribute definition for a location from a Square seller account. Applicable when needing details on custom attributes for specific locations. Accessible only if visibility is set accordingly.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_definition_key", + "required": true, + "description": "The key of the custom attribute definition to retrieve, requiring a qualified key if not the owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_definition_version", + "required": false, + "description": "The version of the custom attribute definition for consistent reads. Must be equal to or less than the latest version to avoid errors.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLocationCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations/custom-attribute-definitions/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "custom_attribute_definition_version", + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_definition_key", + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationDetails.json new file mode 100644 index 00000000..92d4e119 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLocationDetails.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveLocationDetails", + "fully_qualified_name": "SquareupApi.RetrieveLocationDetails@0.1.0", + "description": "Retrieve detailed information about a specific location.\n\nCall this tool to obtain information about a particular location by providing the location ID. Use \"main\" as the ID to get details about the main location.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "location_id", + "required": true, + "description": "The ID of the location to retrieve. Use \"main\" for the main location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to retrieve. Specify the string\n\"main\" to return the main location." + }, + "inferrable": true, + "http_endpoint_parameter_name": "location_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLocation'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/locations/{location_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "location_id", + "tool_parameter_name": "location_id", + "description": "The ID of the location to retrieve. Specify the string\n\"main\" to return the main location.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the location to retrieve. Specify the string\n\"main\" to return the main location." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyAccount.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyAccount.json new file mode 100644 index 00000000..27be1515 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyAccount.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveLoyaltyAccount", + "fully_qualified_name": "SquareupApi.RetrieveLoyaltyAccount@0.1.0", + "description": "Retrieve information about a loyalty account.\n\nUse this tool to get detailed information about a specific loyalty account using the account ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "loyalty_account_id", + "required": true, + "description": "The unique identifier of the loyalty account to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty account](entity:LoyaltyAccount) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "account_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLoyaltyAccount'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "LOYALTY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/loyalty/accounts/{account_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "account_id", + "tool_parameter_name": "loyalty_account_id", + "description": "The ID of the [loyalty account](entity:LoyaltyAccount) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty account](entity:LoyaltyAccount) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyProgram.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyProgram.json new file mode 100644 index 00000000..8873950b --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyProgram.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveLoyaltyProgram", + "fully_qualified_name": "SquareupApi.RetrieveLoyaltyProgram@0.1.0", + "description": "Retrieve details of a seller's loyalty program.\n\nUse this tool to obtain information about a seller's loyalty program by specifying the program ID or using the keyword 'main'. It provides details on how buyers can earn and redeem points.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "loyalty_program_identifier", + "required": true, + "description": "The ID of the loyalty program or the keyword 'main' to retrieve the program details.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the loyalty program or the keyword `main`. Either value can be used to retrieve the single loyalty program that belongs to the seller." + }, + "inferrable": true, + "http_endpoint_parameter_name": "program_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLoyaltyProgram'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "LOYALTY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/loyalty/programs/{program_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "program_id", + "tool_parameter_name": "loyalty_program_identifier", + "description": "The ID of the loyalty program or the keyword `main`. Either value can be used to retrieve the single loyalty program that belongs to the seller.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the loyalty program or the keyword `main`. Either value can be used to retrieve the single loyalty program that belongs to the seller." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyPromotion.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyPromotion.json new file mode 100644 index 00000000..5af4c7f6 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyPromotion.json @@ -0,0 +1,137 @@ +{ + "name": "RetrieveLoyaltyPromotion", + "fully_qualified_name": "SquareupApi.RetrieveLoyaltyPromotion@0.1.0", + "description": "Retrieve details of a specific loyalty promotion.\n\nUse this tool to get information about a specific loyalty promotion identified by program and promotion IDs. Call this tool when you need to access or display details of a particular loyalty promotion.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "loyalty_promotion_id", + "required": true, + "description": "The unique identifier for the loyalty promotion to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty promotion](entity:LoyaltyPromotion) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "promotion_id" + }, + { + "name": "loyalty_program_id", + "required": true, + "description": "The ID of the base loyalty program. Retrieve it by calling RetrieveLoyaltyProgram with the 'main' keyword.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram). To get the program ID,\ncall [RetrieveLoyaltyProgram](api-endpoint:Loyalty-RetrieveLoyaltyProgram) using the `main` keyword." + }, + "inferrable": true, + "http_endpoint_parameter_name": "program_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLoyaltyPromotion'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "LOYALTY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/loyalty/programs/{program_id}/promotions/{promotion_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "promotion_id", + "tool_parameter_name": "loyalty_promotion_id", + "description": "The ID of the [loyalty promotion](entity:LoyaltyPromotion) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty promotion](entity:LoyaltyPromotion) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "program_id", + "tool_parameter_name": "loyalty_program_id", + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram). To get the program ID,\ncall [RetrieveLoyaltyProgram](api-endpoint:Loyalty-RetrieveLoyaltyProgram) using the `main` keyword.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the base [loyalty program](entity:LoyaltyProgram). To get the program ID,\ncall [RetrieveLoyaltyProgram](api-endpoint:Loyalty-RetrieveLoyaltyProgram) using the `main` keyword." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyReward.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyReward.json new file mode 100644 index 00000000..9515b6c5 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveLoyaltyReward.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveLoyaltyReward", + "fully_qualified_name": "SquareupApi.RetrieveLoyaltyReward@0.1.0", + "description": "Retrieve details of a loyalty reward.\n\nThis tool is used to fetch information about a specific loyalty reward by providing the reward ID. It should be called when details about a particular reward are needed.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "loyalty_reward_id", + "required": true, + "description": "The unique ID of the loyalty reward to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty reward](entity:LoyaltyReward) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "reward_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveLoyaltyReward'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "LOYALTY_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/loyalty/rewards/{reward_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "reward_id", + "tool_parameter_name": "loyalty_reward_id", + "description": "The ID of the [loyalty reward](entity:LoyaltyReward) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the [loyalty reward](entity:LoyaltyReward) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantCustomAttribute.json new file mode 100644 index 00000000..c2e9ce26 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantCustomAttribute.json @@ -0,0 +1,137 @@ +{ + "name": "RetrieveMerchantCustomAttribute", + "fully_qualified_name": "SquareupApi.RetrieveMerchantCustomAttribute@0.1.0", + "description": "Retrieve a merchant's custom attribute definition.\n\nThis tool retrieves custom attribute definitions related to a merchant from a Square seller account. It is useful when you need to access specific attribute definitions created within an account. The attribute definition must have a visibility setting of 'VISIBILITY_READ_ONLY' or 'VISIBILITY_READ_WRITE_VALUES' if created by another application.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute definition to retrieve. Use the qualified key if not the definition owner.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "custom_attribute_version", + "required": false, + "description": "The version of the custom attribute definition required for consistent reads. It returns the specified or a higher version if available, or an error if higher than the current version.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveMerchantCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants/custom-attribute-definitions/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "custom_attribute_version", + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The current version of the custom attribute definition, which is used for strongly consistent\nreads to guarantee that you receive the most up-to-date data. When included in the request,\nSquare returns the specified version or a higher version if one exists. If the specified version\nis higher than the current version, Square returns a `BAD_REQUEST` error." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve. If the requesting application\nis not the definition owner, you must use the qualified key." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantInfo.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantInfo.json new file mode 100644 index 00000000..307169d4 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveMerchantInfo.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveMerchantInfo", + "fully_qualified_name": "SquareupApi.RetrieveMerchantInfo@0.1.0", + "description": "Retrieve details of a specific merchant using merchant ID.\n\nUse this tool to obtain the `Merchant` object details by providing the `merchant_id`. It should be called when users need specific information about a merchant via their unique ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "merchant_id", + "required": true, + "description": "The unique ID of the merchant to retrieve. Use 'me' to access the current accessible merchant.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the merchant to retrieve. If the string \"me\" is supplied as the ID,\nthen retrieve the merchant that is currently accessible to this call." + }, + "inferrable": true, + "http_endpoint_parameter_name": "merchant_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveMerchant'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "MERCHANT_PROFILE_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/merchants/{merchant_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "merchant_id", + "tool_parameter_name": "merchant_id", + "description": "The ID of the merchant to retrieve. If the string \"me\" is supplied as the ID,\nthen retrieve the merchant that is currently accessible to this call.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the merchant to retrieve. If the string \"me\" is supplied as the ID,\nthen retrieve the merchant that is currently accessible to this call." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderById.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderById.json new file mode 100644 index 00000000..d1f32ef1 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderById.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveOrderById", + "fully_qualified_name": "SquareupApi.RetrieveOrderById@0.1.0", + "description": "Retrieve order details by Order ID.\n\nUse this tool to retrieve detailed information about a specific order using its Order ID. It is useful for checking order status, contents, and other order-related details.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "order_id", + "required": true, + "description": "The unique identifier for the order to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the order to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "order_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveOrder'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/orders/{order_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "order_id", + "tool_parameter_name": "order_id", + "description": "The ID of the order to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the order to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttribute.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttribute.json new file mode 100644 index 00000000..6be9e4ee --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttribute.json @@ -0,0 +1,201 @@ +{ + "name": "RetrieveOrderCustomAttribute", + "fully_qualified_name": "SquareupApi.RetrieveOrderCustomAttribute@0.1.0", + "description": "Retrieve a custom attribute associated with an order.\n\nThis tool retrieves a custom attribute linked to a specified order. It can also return the custom attribute definition if requested. Use this when you need information about custom fields attached to an order, especially those with specific visibility settings.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "order_id", + "required": true, + "description": "The ID of the target order to retrieve the custom attribute for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [order](entity:Order)." + }, + "inferrable": true, + "http_endpoint_parameter_name": "order_id" + }, + { + "name": "custom_attribute_key", + "required": true, + "description": "The key for retrieving the custom attribute associated with the order. Must match an existing definition key.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the key of an\nexisting custom attribute definition." + }, + "inferrable": true, + "http_endpoint_parameter_name": "custom_attribute_key" + }, + { + "name": "current_version", + "required": false, + "description": "Specify the current version of the custom attribute for optimistic concurrency control. This is an optional integer value.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "To enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency)\ncontrol, include this optional field and specify the current version of the custom attribute." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + }, + { + "name": "include_custom_attribute_definition", + "required": false, + "description": "Set to true to include the custom attribute definition details in the response, such as name, description, and data type.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each \ncustom attribute. Set this parameter to `true` to get the name and description of each custom attribute, \ninformation about the data type, or other definition details. The default value is `false`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "with_definition" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveOrderCustomAttribute'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/orders/{order_id}/custom-attributes/{custom_attribute_key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "current_version", + "description": "To enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency)\ncontrol, include this optional field and specify the current version of the custom attribute.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "To enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency)\ncontrol, include this optional field and specify the current version of the custom attribute." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "with_definition", + "tool_parameter_name": "include_custom_attribute_definition", + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each \ncustom attribute. Set this parameter to `true` to get the name and description of each custom attribute, \ninformation about the data type, or other definition details. The default value is `false`.", + "value_schema": { + "val_type": "boolean", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each \ncustom attribute. Set this parameter to `true` to get the name and description of each custom attribute, \ninformation about the data type, or other definition details. The default value is `false`." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "order_id", + "tool_parameter_name": "order_id", + "description": "The ID of the target [order](entity:Order).", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the target [order](entity:Order)." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "custom_attribute_key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute to retrieve. This key must match the key of an\nexisting custom attribute definition.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute to retrieve. This key must match the key of an\nexisting custom attribute definition." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttributeDefinition.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttributeDefinition.json new file mode 100644 index 00000000..168e6335 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveOrderCustomAttributeDefinition.json @@ -0,0 +1,137 @@ +{ + "name": "RetrieveOrderCustomAttributeDefinition", + "fully_qualified_name": "SquareupApi.RetrieveOrderCustomAttributeDefinition@0.1.0", + "description": "Retrieve custom attribute definition for a Square order.\n\nUse this tool to fetch a specific custom attribute definition related to an order from a Square seller account. The custom attribute must be set to specific visibility settings to be accessible.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "custom_attribute_key", + "required": true, + "description": "The key of the custom attribute definition to retrieve for an order.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "key" + }, + { + "name": "current_version_of_custom_attribute", + "required": false, + "description": "Specify the current version of the custom attribute for optimistic concurrency control. Optional.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "To enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency)\ncontrol, include this optional field and specify the current version of the custom attribute." + }, + "inferrable": true, + "http_endpoint_parameter_name": "version" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveOrderCustomAttributeDefinition'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/orders/custom-attribute-definitions/{key}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "version", + "tool_parameter_name": "current_version_of_custom_attribute", + "description": "To enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency)\ncontrol, include this optional field and specify the current version of the custom attribute.", + "value_schema": { + "val_type": "integer", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "To enable [optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency)\ncontrol, include this optional field and specify the current version of the custom attribute." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "key", + "tool_parameter_name": "custom_attribute_key", + "description": "The key of the custom attribute definition to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The key of the custom attribute definition to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrievePaymentLink.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrievePaymentLink.json new file mode 100644 index 00000000..83516291 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrievePaymentLink.json @@ -0,0 +1,105 @@ +{ + "name": "RetrievePaymentLink", + "fully_qualified_name": "SquareupApi.RetrievePaymentLink@0.1.0", + "description": "Retrieve details of a specified payment link.\n\nUse this tool to get details about a specific payment link by providing its unique ID. Ideal for retrieving information about payment transactions handled via Squareup.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "payment_link_id", + "required": true, + "description": "The unique ID of the payment link to retrieve details for.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of link to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrievePaymentLink'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ORDERS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/online-checkout/payment-links/{id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "payment_link_id", + "description": "The ID of link to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of link to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSiteSnippet.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSiteSnippet.json new file mode 100644 index 00000000..a42ee0b0 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSiteSnippet.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveSiteSnippet", + "fully_qualified_name": "SquareupApi.RetrieveSiteSnippet@0.1.0", + "description": "Retrieve snippets from a Square Online site.\n\nUse this tool to retrieve the snippet added by your application from a specified Square Online site. Ideal for accessing custom code snippets associated with your applications on Square sites.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "site_identifier", + "required": true, + "description": "The unique ID of the Square Online site containing your application's snippet.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the site that contains the snippet." + }, + "inferrable": true, + "http_endpoint_parameter_name": "site_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveSnippet'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "ONLINE_STORE_SNIPPETS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/sites/{site_id}/snippet", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "site_id", + "tool_parameter_name": "site_identifier", + "description": "The ID of the site that contains the snippet.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the site that contains the snippet." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSubscription.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSubscription.json new file mode 100644 index 00000000..bff22690 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveSubscription.json @@ -0,0 +1,137 @@ +{ + "name": "RetrieveSubscription", + "fully_qualified_name": "SquareupApi.RetrieveSubscription@0.1.0", + "description": "Retrieve details of a specific subscription.\n\nThis tool retrieves information about a specific subscription using its ID. It is called when detailed subscription data is needed, such as for review or management purposes.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "subscription_id", + "required": true, + "description": "The ID of the subscription to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "subscription_id" + }, + { + "name": "include_related_info", + "required": false, + "description": "Specify related info to include in the response, such as 'actions' for scheduled actions.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A query parameter to specify related information to be included in the response. \n\nThe supported query parameter values are: \n\n- `actions`: to include scheduled actions on the targeted subscription." + }, + "inferrable": true, + "http_endpoint_parameter_name": "include" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveSubscription'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "SUBSCRIPTIONS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/subscriptions/{subscription_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "include", + "tool_parameter_name": "include_related_info", + "description": "A query parameter to specify related information to be included in the response. \n\nThe supported query parameter values are: \n\n- `actions`: to include scheduled actions on the targeted subscription.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "A query parameter to specify related information to be included in the response. \n\nThe supported query parameter values are: \n\n- `actions`: to include scheduled actions on the targeted subscription." + }, + "accepted_as": "query", + "required": false, + "deprecated": false, + "documentation_urls": [] + }, + { + "name": "subscription_id", + "tool_parameter_name": "subscription_id", + "description": "The ID of the subscription to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the subscription to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberBookingProfile.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberBookingProfile.json new file mode 100644 index 00000000..9d101df0 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberBookingProfile.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveTeamMemberBookingProfile", + "fully_qualified_name": "SquareupApi.RetrieveTeamMemberBookingProfile@0.1.0", + "description": "Retrieve a team member's booking profile details.\n\nUse this tool to access the booking profile of a specific team member by their ID.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "team_member_id", + "required": true, + "description": "The unique ID of the team member whose booking profile you want to retrieve. Must be a valid string identifier.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the team member to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "team_member_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveTeamMemberBookingProfile'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "APPOINTMENTS_BUSINESS_SETTINGS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/bookings/team-member-booking-profiles/{team_member_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "team_member_id", + "tool_parameter_name": "team_member_id", + "description": "The ID of the team member to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the team member to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberDetails.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberDetails.json new file mode 100644 index 00000000..433e3357 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberDetails.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveTeamMemberDetails", + "fully_qualified_name": "SquareupApi.RetrieveTeamMemberDetails@0.1.0", + "description": "Retrieve details of a team member by ID.\n\nUse this tool to access detailed information about a specific team member using their unique ID. This is useful for managing or reviewing team member profiles.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "team_member_id", + "required": true, + "description": "The unique identifier of the team member whose details you want to retrieve. This ID is required to access specific team member information.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the team member to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "team_member_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveTeamMember'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "EMPLOYEES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/team-members/{team_member_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "team_member_id", + "tool_parameter_name": "team_member_id", + "description": "The ID of the team member to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the team member to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberWageSetting.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberWageSetting.json new file mode 100644 index 00000000..d8246a58 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTeamMemberWageSetting.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveTeamMemberWageSetting", + "fully_qualified_name": "SquareupApi.RetrieveTeamMemberWageSetting@0.1.0", + "description": "Retrieve wage setting details for a specific team member.\n\nThis tool retrieves the wage setting for a team member based on their ID. Use this when you need to access detailed wage information about a specific member. It is recommended to use RetrieveTeamMember or SearchTeamMembers for related queries.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "team_member_id", + "required": true, + "description": "The unique identifier for the team member whose wage setting is to be retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the team member for which to retrieve the wage setting." + }, + "inferrable": true, + "http_endpoint_parameter_name": "team_member_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveWageSetting'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "EMPLOYEES_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/team-members/{team_member_id}/wage-setting", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "team_member_id", + "tool_parameter_name": "team_member_id", + "description": "The ID of the team member for which to retrieve the wage setting.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the team member for which to retrieve the wage setting." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTerminalCheckout.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTerminalCheckout.json new file mode 100644 index 00000000..2d9dc132 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTerminalCheckout.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveTerminalCheckout", + "fully_qualified_name": "SquareupApi.RetrieveTerminalCheckout@0.1.0", + "description": "Retrieve a Terminal checkout request by ID.\n\nThis tool retrieves the details of a Terminal checkout request using a unique `checkout_id`. It should be called to access checkout information up to 30 days after the request was created.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "terminal_checkout_id", + "required": true, + "description": "The unique ID used to retrieve details of a Terminal checkout request. Valid for 30 days.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalCheckout`." + }, + "inferrable": true, + "http_endpoint_parameter_name": "checkout_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'GetTerminalCheckout'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "PAYMENTS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/terminals/checkouts/{checkout_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "checkout_id", + "tool_parameter_name": "terminal_checkout_id", + "description": "The unique ID for the desired `TerminalCheckout`.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The unique ID for the desired `TerminalCheckout`." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTimecard.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTimecard.json new file mode 100644 index 00000000..718b59ce --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTimecard.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveTimecard", + "fully_qualified_name": "SquareupApi.RetrieveTimecard@0.1.0", + "description": "Retrieve a specific timecard using its ID.\n\nUse this tool to fetch detailed information about a single timecard by providing its unique identifier.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "timecard_uuid", + "required": true, + "description": "The unique identifier (UUID) for the Timecard to be retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `Timecard` being retrieved." + }, + "inferrable": true, + "http_endpoint_parameter_name": "id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveTimecard'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "TIMECARDS_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/labor/timecards/{id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "id", + "tool_parameter_name": "timecard_uuid", + "description": "The UUID for the `Timecard` being retrieved.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The UUID for the `Timecard` being retrieved." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTokenStatus.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTokenStatus.json new file mode 100644 index 00000000..0ba21d35 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveTokenStatus.json @@ -0,0 +1,67 @@ +{ + "name": "RetrieveTokenStatus", + "fully_qualified_name": "SquareupApi.RetrieveTokenStatus@0.1.0", + "description": "Retrieve the status of an OAuth or personal access token.\n\nThis tool checks the status of a Square OAuth access token or a personal access token. It should be called to verify if a token is active or expired. Ensure the token is included in the Authorization header as 'Bearer ACCESS_TOKEN'.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveTokenStatus'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/oauth2/token/status", + "http_method": "POST", + "headers": {}, + "parameters": [], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveVendorInfo.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveVendorInfo.json new file mode 100644 index 00000000..3d5acb06 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveVendorInfo.json @@ -0,0 +1,105 @@ +{ + "name": "RetrieveVendorInfo", + "fully_qualified_name": "SquareupApi.RetrieveVendorInfo@0.1.0", + "description": "Retrieve detailed information about a vendor by ID.\n\nThis tool is used to fetch detailed information about a specific vendor using their Vendor ID. It is helpful when you need comprehensive vendor details.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "vendor_id", + "required": true, + "description": "The ID of the vendor whose information you want to retrieve. This should be a unique string identifier.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [Vendor](entity:Vendor) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "vendor_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveVendor'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "VENDOR_READ" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/vendors/{vendor_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "vendor_id", + "tool_parameter_name": "vendor_id", + "description": "ID of the [Vendor](entity:Vendor) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "ID of the [Vendor](entity:Vendor) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveWebhookSubscription.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveWebhookSubscription.json new file mode 100644 index 00000000..9f21c350 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/RetrieveWebhookSubscription.json @@ -0,0 +1,101 @@ +{ + "name": "RetrieveWebhookSubscription", + "fully_qualified_name": "SquareupApi.RetrieveWebhookSubscription@0.1.0", + "description": "Retrieve details of a specific webhook subscription by ID.\n\nUse this tool to fetch information about a webhook subscription using its unique identifier. This is useful when you need to verify the configuration or details of a specific webhook subscription.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "webhook_subscription_id", + "required": true, + "description": "The unique identifier of the webhook subscription to be retrieved. This is a required parameter.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "[REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to retrieve." + }, + "inferrable": true, + "http_endpoint_parameter_name": "subscription_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'RetrieveWebhookSubscription'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": null + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/webhooks/subscriptions/{subscription_id}", + "http_method": "GET", + "headers": {}, + "parameters": [ + { + "name": "subscription_id", + "tool_parameter_name": "webhook_subscription_id", + "description": "[REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to retrieve.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "[REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to retrieve." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/SubmitDisputeEvidence.json b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/SubmitDisputeEvidence.json new file mode 100644 index 00000000..d31c1af3 --- /dev/null +++ b/toolkits/squareup_api/arcade_squareup_api/wrapper_tools/SubmitDisputeEvidence.json @@ -0,0 +1,105 @@ +{ + "name": "SubmitDisputeEvidence", + "fully_qualified_name": "SquareupApi.SubmitDisputeEvidence@0.1.0", + "description": "Submit evidence to a cardholder's bank for a dispute.\n\nThis tool is used to submit evidence related to a dispute to the cardholder's bank. It includes evidence uploaded through specific Square endpoints and any automatically provided evidence. Evidence cannot be removed once submitted.", + "toolkit": { + "name": "ArcadeSquareupApi", + "description": null, + "version": "0.1.0" + }, + "input": { + "parameters": [ + { + "name": "dispute_id", + "required": true, + "description": "The unique identifier for the dispute to which you are submitting evidence. You need this ID to ensure the evidence is attached to the correct dispute case.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute for which you want to submit evidence." + }, + "inferrable": true, + "http_endpoint_parameter_name": "dispute_id" + } + ] + }, + "output": { + "description": "Response from the API endpoint 'SubmitEvidence'.", + "available_modes": [ + "value", + "error", + "null" + ], + "value_schema": { + "val_type": "json", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": null + } + }, + "requirements": { + "authorization": { + "provider_id": "arcade-squareup", + "provider_type": "oauth2", + "id": null, + "oauth2": { + "scopes": [ + "DISPUTES_WRITE" + ] + } + }, + "secrets": null, + "metadata": null + }, + "deprecation_message": null, + "metadata": { + "object_type": "api_wrapper_tool", + "version": "1.0.0", + "description": "Tools that enable LLMs to interact directly with the squareup API." + }, + "http_endpoint": { + "metadata": { + "object_type": "http_endpoint", + "version": "1.0.0", + "description": "" + }, + "url": "https://connect.squareup.com/v2/disputes/{dispute_id}/submit-evidence", + "http_method": "POST", + "headers": {}, + "parameters": [ + { + "name": "dispute_id", + "tool_parameter_name": "dispute_id", + "description": "The ID of the dispute for which you want to submit evidence.", + "value_schema": { + "val_type": "string", + "inner_val_type": null, + "enum": null, + "properties": null, + "inner_properties": null, + "description": "The ID of the dispute for which you want to submit evidence." + }, + "accepted_as": "path", + "required": true, + "deprecated": false, + "documentation_urls": [] + } + ], + "documentation_urls": [], + "secrets": [ + { + "arcade_key": "auth_token", + "parameter_name": "Authorization", + "accepted_as": "header", + "formatted_value": "Bearer {authorization}", + "description": "The OAuth token to use for authentication.", + "is_auth_token": true + } + ] + } +} diff --git a/toolkits/squareup_api/pyproject.toml b/toolkits/squareup_api/pyproject.toml new file mode 100644 index 00000000..bbeced26 --- /dev/null +++ b/toolkits/squareup_api/pyproject.toml @@ -0,0 +1,61 @@ +[build-system] +requires = [ "hatchling",] +build-backend = "hatchling.build" + +[project] +name = "arcade_squareup_api" +version = "0.1.0" +description = "Tools that enable LLMs to interact directly with the squareup API." +requires-python = ">=3.10" +dependencies = [ + "arcade-tdk>=2.0.0,<3.0.0", + "httpx[http2]>=0.27.2,<1.0.0", +] +[[project.authors]] +email = "support@arcade.dev" + + +[project.optional-dependencies] +dev = [ + "arcade-mcp[all]>=1.0.0rc2,<3.0.0", + "arcade-serve>=2.0.0,<3.0.0", + "pytest>=8.3.0,<8.4.0", + "pytest-cov>=4.0.0,<4.1.0", + "pytest-mock>=3.11.1,<3.12.0", + "pytest-asyncio>=0.24.0,<0.25.0", + "mypy>=1.5.1,<1.6.0", + "pre-commit>=3.4.0,<3.5.0", + "tox>=4.11.1,<4.12.0", + "ruff>=0.7.4,<0.8.0", + "httpx[http2]>=0.27.2,<1.0.0", +] + +# Tell Arcade.dev that this package is a toolkit +[project.entry-points.arcade_toolkits] +toolkit_name = "arcade_squareup_api" + +# Use local path sources for arcade libs when working locally +[tool.uv.sources] +arcade-mcp = { path = "../../", editable = true } +arcade-serve = { path = "../../libs/arcade-serve/", editable = true } +arcade-tdk = { path = "../../libs/arcade-tdk/", editable = true } +[tool.mypy] +files = [ "arcade_squareup_api/**/*.py",] +python_version = "3.10" +disallow_untyped_defs = "True" +disallow_any_unimported = "True" +no_implicit_optional = "True" +check_untyped_defs = "True" +warn_return_any = "True" +warn_unused_ignores = "True" +show_error_codes = "True" +ignore_missing_imports = "True" + +[tool.pytest.ini_options] +testpaths = [ "tests",] + +[tool.coverage.report] +skip_empty = true + +[tool.hatch.build.targets.wheel] +packages = [ "arcade_squareup_api",] diff --git a/toolkits/squareup_api/tests/__init__.py b/toolkits/squareup_api/tests/__init__.py new file mode 100644 index 00000000..e69de29b