Skip to Content
Herramienta CLIReferencia Cruzada API ↔ CLI

Referencia Cruzada API ↔ CLI

Cada endpoint REST de Koywe expuesto por @koyweforest/cli v0.14.1, indexado por recurso. Comienza aquí si ya sabes qué endpoint HTTP quieres llamar y necesitas la invocación CLI correspondiente.

La vista inversa (indexada por comando CLI) está en la página Referencia de Comandos CLI. El JSON subyacente se publica en /cli-commands.json.

126 comandos mapean directamente a endpoints REST. 16 comandos son exclusivos del CLI (auth local, flujos guiados, configuración) y se listan al final.

Endpoints raíz

applicant-company-roles

MétodoRutaCLIDescripción
GET/applicant-company-roleskoywe reference company-rolesList applicant company roles

auth

MétodoRutaCLIDescripción
POST/auth/credentials/rotate-secretkoywe auth rotate-secretRotate API secret for the current API user
GET/auth/mekoywe auth meGet current user information
POST/auth/organizations/{orgId}/api-users/mfa/preparekoywe auth mfa prepareStart delegated MFA enrollment by sending your public key
POST/auth/organizations/{orgId}/credentialskoywe auth credentials create-orgCreate API credentials for an organization
POST/auth/organizations/{orgId}/merchants/{merchantId}/credentialskoywe auth credentials createCreate API credentials for a merchant
POST/auth/organizations/{orgId}/merchants/{merchantId}/pos/credentials/createkoywe auth credentials create-posCreate POS credentials for a merchant
POST/auth/sign-inkoywe auth loginAuthenticate with API key and secret

banks

MétodoRutaCLIDescripción
GET/bankskoywe banks listList available banks

countries

MétodoRutaCLIDescripción
GET/countrieskoywe countries listList available countries
GET/countries/{countrySymbol}/economic-activitieskoywe countries economic-activitiesList economic activities for a country
GET/countries/{countrySymbol}/stateskoywe countries statesList states for a country
GET/countries/{countrySymbol}/states/{stateId}koywe countries state-infoGet state details
GET/countries/{countrySymbol}/states/{stateId}/countieskoywe countries countiesList counties for a state
GET/countries/{countrySymbol}/states/{stateId}/counties/{countyId}koywe countries county-infoGet county details

currencies

MétodoRutaCLIDescripción
GET/currencieskoywe currencies listList available currencies
GET/currencies/{id}koywe currencies infoGet currency details by ID
GET/currencies/symbol/{symbol}koywe currencies by-symbolGet currency by symbol

documents

MétodoRutaCLIDescripción
GET/documentskoywe documents listList available document types

economic-activities

MétodoRutaCLIDescripción
GET/economic-activitieskoywe countries economic-activities-allList all economic activities (global, not country-specific)

global-feature-flags

MétodoRutaCLIDescripción
GET/global-feature-flagskoywe reference feature-flagsList global feature flags

me

MétodoRutaCLIDescripción
POST/me/notificationskoywe notifications send-personalSend a personal notification

onboarding

MétodoRutaCLIDescripción
GET/onboarding/mekoywe onboarding meGet your onboarding status

organizations

MétodoRutaCLIDescripción
GET/organizationskoywe org listList all organizations

payment-method

MétodoRutaCLIDescripción
GET/payment-methodkoywe payment-methods listList available payment methods
GET/payment-method/card/merchants/{merchantId}/verifykoywe payment-methods verify-cardVerify card payment method for a merchant

pre-onboarding

MétodoRutaCLIDescripción
POST/pre-onboarding/registration-draftkoywe pre-onboarding drafts createCreate a new registration draft
GET/pre-onboarding/registration-draft/{draftId}koywe pre-onboarding drafts infoGet a registration draft by ID
PUT/pre-onboarding/registration-draft/{draftId}koywe pre-onboarding drafts updateUpdate an existing registration draft (auto-merges with existing data)
POST/pre-onboarding/registration-form/{draftId}koywe pre-onboarding drafts submitSubmit a registration draft for review
GET/pre-onboarding/registrationskoywe pre-onboarding registrations listList all registrations
GET/pre-onboarding/registrations/{registrationId}/statuskoywe pre-onboarding registrations statusGet registration status

users

MétodoRutaCLIDescripción
GET/users/mekoywe users meGet the authenticated user profile
GET/users/organizations/{orgId}/invitationskoywe users org-invitations listList invitations at the organization level
POST/users/organizations/{orgId}/invitationskoywe users org-invitations createInvite a user at the organization level
GET/users/organizations/{orgId}/merchants/{merchantId}/invitationskoywe users invitations listList invitations for the current merchant
POST/users/organizations/{orgId}/merchants/{merchantId}/invitationskoywe users invitations createInvite a user to the merchant

Endpoints a nivel de organización

Prefijo: /organizations/{orgId}/

balances

MétodoRutaCLIDescripción
GET/organizations/{orgId}/balanceskoywe org balancesGet organization balances

feature-flags

MétodoRutaCLIDescripción
GET/organizations/{orgId}/feature-flagskoywe org feature-flagsGet organization feature flags

merchants

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchantskoywe merchant listList merchants in the current organization
POST/organizations/{orgId}/merchantskoywe merchant createCreate a new merchant
DELETE/organizations/{orgId}/merchants/{merchantId}koywe merchant deleteDelete a merchant
GET/organizations/{orgId}/merchants/{merchantId}koywe merchant infoGet current merchant details
PUT/organizations/{orgId}/merchants/{merchantId}koywe merchant updateUpdate merchant details

policy

MétodoRutaCLIDescripción
DELETE/organizations/{orgId}/policykoywe policy deleteDelete the current policy
GET/organizations/{orgId}/policykoywe policy infoGet current policy configuration
POST/organizations/{orgId}/policykoywe policy createCreate a new policy
GET/organizations/{orgId}/policy/approvalskoywe policy approvals listList pending policy approvals
GET/organizations/{orgId}/policy/approvals/{approvalId}koywe policy approvals infoGet approval details
POST/organizations/{orgId}/policy/approvals/{approvalId}/approvekoywe policy approvals approveApprove a pending approval (requires MFA)
POST/organizations/{orgId}/policy/approvals/{approvalId}/rejectkoywe policy approvals rejectReject a pending approval (requires MFA)
GET/organizations/{orgId}/policy/auditkoywe policy auditView policy audit log
POST/organizations/{orgId}/policy/ruleskoywe policy rules createAdd a rule to the policy
DELETE/organizations/{orgId}/policy/rules/{ruleId}koywe policy rules deleteDelete a policy rule
PUT/organizations/{orgId}/policy/rules/{ruleId}koywe policy rules updateUpdate a policy rule
PUT/organizations/{orgId}/policy/rules/reorderkoywe policy rules reorderReorder policy rules

users

MétodoRutaCLIDescripción
GET/organizations/{orgId}/userskoywe users org-listList users at the organization level
PUT/organizations/{orgId}/userskoywe users org-update-rolesUpdate roles for a user at the organization level

webauthn

MétodoRutaCLIDescripción
POST/organizations/{orgId}/webauthn/challengekoywe auth mfa challengeRequest an MFA challenge nonce
POST/organizations/{orgId}/webauthn/challenge
/verify
koywe auth mfa challenge-signFull MFA flow: challenge → sign → verify → return mfaToken
POST/organizations/{orgId}/webauthn/verifykoywe auth mfa verifySubmit a signed stamp to verify MFA and receive an mfaToken

webhook-event-types

MétodoRutaCLIDescripción
GET/organizations/{orgId}/webhook-event-typeskoywe webhooks event-typesList available webhook event types, grouped by category

webhook-events

MétodoRutaCLIDescripción
GET/organizations/{orgId}/webhook-eventskoywe webhooks events listList webhook events
GET/organizations/{orgId}/webhook-events/{eventId}koywe webhooks events infoGet webhook event details
GET/organizations/{orgId}/webhook-events/{eventId}/deliverieskoywe webhooks events deliveriesGet deliveries for a webhook event
POST/organizations/{orgId}/webhook-events/{eventId}/replaykoywe webhooks events replayReplay a webhook event delivery

webhooks

MétodoRutaCLIDescripción
GET/organizations/{orgId}/webhookskoywe webhooks listList webhooks for the current organization
POST/organizations/{orgId}/webhookskoywe webhooks createCreate a new webhook
DELETE/organizations/{orgId}/webhooks/{webhookId}koywe webhooks deleteDelete a webhook
GET/organizations/{orgId}/webhooks/{webhookId}koywe webhooks infoGet webhook details
POST/organizations/{orgId}/webhooks/{webhookId}/pausekoywe webhooks pausePause a webhook
POST/organizations/{orgId}/webhooks/{webhookId}/pingkoywe webhooks pingSend a test ping to a webhook
POST/organizations/{orgId}/webhooks/{webhookId}/resumekoywe webhooks resumeResume a paused webhook
POST/organizations/{orgId}/webhooks/{webhookId}/rotate-secretkoywe webhooks rotate-secretRotate webhook secret
PATCH/organizations/{orgId}/webhooks/{webhookId}/subscriptionskoywe webhooks subscriptions updateUpdate the event types a webhook endpoint is subscribed to

Endpoints a nivel de comercio

Prefijo: /organizations/{orgId}/merchants/{merchantId}/

accounts

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/accountskoywe bank-accounts listList external bank accounts
POST/organizations/{orgId}/merchants/{merchantId}/accountskoywe bank-accounts createCreate an external bank account
DELETE/organizations/{orgId}/merchants/{merchantId}/accounts/{accountId}koywe bank-accounts deleteDelete a bank account
GET/organizations/{orgId}/merchants/{merchantId}/accounts/{accountId}koywe bank-accounts infoGet bank account details
PUT/organizations/{orgId}/merchants/{merchantId}/accounts/{accountId}koywe bank-accounts updateUpdate a bank account
GET/organizations/{orgId}/merchants/{merchantId}/accounts/{accountId}/balancekoywe bank-accounts balanceGet balance for a specific account
GET/organizations/{orgId}/merchants/{merchantId}/accounts/{accountId}/reports/ledger-entry/{entryId}koywe reports ledger-entryGet a specific ledger entry
GET/organizations/{orgId}/merchants/{merchantId}/accounts/{accountId}/reports/ledger-statementkoywe reports ledgerGet ledger statement for an account
GET/organizations/{orgId}/merchants/{merchantId}/accounts/{accountId}/reports/orderskoywe reports ordersGet orders report for an account
GET/organizations/{orgId}/merchants/{merchantId}/accounts/balanceskoywe bank-accounts balancesGet balances for all accounts
POST/organizations/{orgId}/merchants/{merchantId}/accounts/confirm-mfakoywe bank-accounts confirm-mfaConfirm MFA for a pending account approval
GET/organizations/{orgId}/merchants/{merchantId}/accounts/searchkoywe bank-accounts searchSearch bank accounts

bankIncome

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/bankIncome/accountskoywe bank-accounts deposit-infoGet deposit account information (bank income)

contacts

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/contactskoywe contacts listList contacts for the current merchant
POST/organizations/{orgId}/merchants/{merchantId}/contactskoywe contacts createCreate a new contact
DELETE/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}koywe contacts deleteDelete a contact
GET/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}koywe contacts infoGet contact details
PUT/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}koywe contacts updateUpdate an existing contact
GET/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}/accountskoywe contacts accounts listList accounts for a contact
POST/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}/accountskoywe contacts accounts createCreate an account for a contact
DELETE/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}/accounts/{accountId}koywe contacts accounts deleteDelete an account for a contact
GET/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}/accounts/{accountId}koywe contacts accounts infoGet account details for a contact
PUT/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}/accounts/{accountId}koywe contacts accounts updateUpdate an account for a contact
POST/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}/accounts/confirm-mfakoywe contacts accounts confirm-mfaConfirm MFA for a pending contact account approval
DELETE/organizations/{orgId}/merchants/{merchantId}/contacts/{contactId}/documentskoywe contacts documents deleteDelete documents for a contact

deals

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/dealskoywe deals listList deals for the current merchant
POST/organizations/{orgId}/merchants/{merchantId}/dealskoywe deals createCreate a new deal
GET/organizations/{orgId}/merchants/{merchantId}/deals/{dealId}koywe deals infoGet deal details by ID
POST/organizations/{orgId}/merchants/{merchantId}/deals/{dealId}/confirmkoywe deals confirmConfirm MFA for a pending deal approval
POST/organizations/{orgId}/merchants/{merchantId}/deals/{dealId}/transferkoywe deals transferTransfer a scheduled deal

features

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/featureskoywe merchant featuresList features for the current merchant

notifications

MétodoRutaCLIDescripción
POST/organizations/{orgId}/merchants/{merchantId}/notificationskoywe notifications sendSend a notification for a merchant

onboarding

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/onboarding/kybkoywe onboarding kyb listList KYB processes for a merchant
POST/organizations/{orgId}/merchants/{merchantId}/onboarding/kybkoywe onboarding kyb triggerTrigger a KYB process for a merchant
GET/organizations/{orgId}/merchants/{merchantId}/onboarding/kyb/{kybId}koywe onboarding kyb statusGet KYB process status

orders

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/orderskoywe orders listList orders for the current merchant
POST/organizations/{orgId}/merchants/{merchantId}/orderskoywe orders createCreate a new order (PAYIN, PAYOUT, ONRAMP, OFFRAMP, BALANCE_TRANSFER, PAYMENT_LINK, INTER_MERCHANT_TRANSFER)
GET/organizations/{orgId}/merchants/{merchantId}/orders/{orderId}koywe orders infoGet order details by ID
PATCH/organizations/{orgId}/merchants/{merchantId}/orders/{orderId}koywe orders updateUpdate an order (e.g. associate a blockchain tx hash)
POST/organizations/{orgId}/merchants/{merchantId}/orders/{orderId}/confirmkoywe orders confirmConfirm an ON_HOLD order via MFA
POST/organizations/{orgId}/merchants/{merchantId}/orders/{orderId}/notificationkoywe orders notifySend a notification for an order
GET/organizations/{orgId}/merchants/{merchantId}/orders/{orderId}/signkoywe orders sign prepareGet the signing payload for an ON_HOLD order
POST/organizations/{orgId}/merchants/{merchantId}/orders/{orderId}/sign/confirmkoywe orders sign confirmSubmit a stamped signature for an order
GET/organizations/{orgId}/merchants/{merchantId}/orders/external/{externalId}koywe orders get-by-external-idGet order by external (merchant-provided) ID

quotes

MétodoRutaCLIDescripción
POST/organizations/{orgId}/merchants/{merchantId}/quoteskoywe quotes createCreate a new quote
GET/organizations/{orgId}/merchants/{merchantId}/quotes/{quoteId}koywe quotes infoGet quote details

users

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/userskoywe users listList users for the current merchant
PUT/organizations/{orgId}/merchants/{merchantId}/userskoywe users update-rolesUpdate roles for a user at the merchant level

virtual-accounts

MétodoRutaCLIDescripción
GET/organizations/{orgId}/merchants/{merchantId}/virtual-accountskoywe bank-accounts virtual listList virtual bank accounts
POST/organizations/{orgId}/merchants/{merchantId}/virtual-accountskoywe bank-accounts virtual createCreate a virtual bank account
PATCH/organizations/{orgId}/merchants/{merchantId}/virtual-accounts/{accountId}/aliaskoywe bank-accounts virtual update-aliasUpdate virtual account alias

Comandos exclusivos del CLI (sin endpoint REST)

Estos comandos son locales al CLI — handshakes de auth en navegador, flujos guiados multi-paso y gestión de configuración. Orquestan múltiples llamadas API o manipulan estado local, por lo que no se mapean uno-a-uno a un solo endpoint.

CLIDescripción
koywe auth browser-loginAuthenticate via browser-based login
koywe auth mfa keygenGenerate a P-256 keypair for delegated signing
koywe auth mfa signSign a body with your delegated P-256 key (local operation, no API call)
koywe config profile addCreate a new profile
koywe config profile listList all profiles
koywe config profile removeRemove a profile (cannot remove the active profile)
koywe config profile useSwitch to a named profile
koywe config resetReset all configuration and cached tokens
koywe config setSet a configuration value in the active profile
koywe config showDisplay current configuration (active profile)
koywe flow dealCreate a crypto deal: get quote → create deal → optionally transfer
koywe flow orderCreate an order: get quote → create order → wait for approval if needed
koywe initSet up CLI credentials: log in via browser, then create API keys via the API
koywe merchant selectSet the active merchant context
koywe org selectSet the active organization context
koywe setupNew user setup: sign up via browser, then submit a pre-onboarding registration
Last updated on