Mutations

Authentication

register

mutation {
  register(email: "[email protected]", password: "securePass123!", recaptcha_token: "token") {
    success
    message
  }
}

login

mutation {
  login(email: "[email protected]", password: "pass", recaptcha_token: "token") {
    ... on AuthPayload {
      accessToken
      refreshToken
      idToken
    }
    ... on TwoFactorRequired {
      user_id
      message
    }
  }
}

verify_2fa_code

mutation {
  verify_2fa_code(user_id: "user_123", token: "123456") {
    accessToken
    refreshToken
  }
}

refresh_token

mutation {
  refresh_token(token: "refresh_token_here") {
    accessToken
    refreshToken
  }
}

logout / logout_all

mutation { logout(token: "refresh_token") }
mutation { logout_all }

OAuth

mutation { google_auth(token: "google_oauth_token") { ... on AuthPayload { accessToken } } }
mutation { x_auth(token: "twitter_oauth_token") { ... on AuthPayload { accessToken } } }
mutation { apple_auth(token: "apple_id_token") { ... on AuthPayload { accessToken } } }

Email Verification

mutation { verify_email(token: "verification_token") { accessToken } }

Password Recovery

mutation { forgot_password(email: "[email protected]", recaptcha_token: "token") { success message } }
mutation { reset_password(token: "reset_token", password: "newPass123!") { success message } }

2FA Management

mutation { generate_2fa { secret qr_code } }
mutation { enable_2fa(token: "123456") }
mutation { disable_2fa }

User

change_email

mutation { change_email(new_email: "[email protected]") { success message } }

confirm_email_change

mutation { confirm_email_change(token: "token") { success message } }

change_password

mutation { change_password(current_password: "old", new_password: "new") { success message } }

Organizations

mutation { createOrganization(input: { name: "My Org", description: "..." }) { id name } }
mutation { updateOrganization(id: "org_123", input: { name: "Updated" }) { id name } }
mutation { deleteOrganization(id: "org_123") }
mutation { inviteUserToOrganization(organization_id: "org_123", email: "[email protected]", role: "member") }
mutation { removeUserFromOrganization(organization_id: "org_123", user_id: "user_456") }

Exchange Accounts

mutation {
  createExchangeAccount(input: {
    exchange_name: "binance"
    account_name: "My Binance"
    trading_type: "spot"
    api_key: "..."
    api_secret: "..."
  }) { id exchange_name is_active }
}

mutation { deleteExchangeAccount(id: "exc_123") }
mutation { syncExchangeBalance(id: "exc_123") { id balance last_sync_at } }
mutation { test_exchange_account(account: { exchange_name: "binance", api_key: "...", api_secret: "..." }) { success error } }

Strategies

mutation {
  create_strategy(strategy: {
    exchange_account_id: "exc_123"
    name: "BTC Momentum"
    risk_level: 3
  }) { success data { id name } }
}

mutation { update_strategy(strategy: { id: "str_123", name: "Updated" }) { success data { id } } }
mutation { delete_strategy(id: "str_123") { success } }
mutation { link_copiers(strategy_id: "str_123", copier_ids: ["cop_456"]) { success linked_count } }

Copiers

mutation {
  create_copier(copier: {
    exchange_account_id: "exc_456"
    strategy_id: "str_123"
    name: "My Copier"
  }) { success data { id name } }
}

mutation { update_copier(copier: { id: "cop_123", name: "Updated" }) { success } }
mutation { delete_copier(id: "cop_123") { success } }
mutation { toggleCopierStatus(id: "cop_123") { id is_active } }

Trades

mutation {
  createTrade(input: {
    exchange_account_id: "exc_123"
    trade_pair_id: "tp_btcusdt"
    type: "LIMIT"
    side: "BUY"
    price: 50000
    amount: 0.1
  }) { id status }
}

mutation { cancelTrade(id: "trd_123") { id status } }

Notifications

mutation { markNotificationAsRead(id: "notif_123") { id } }
mutation { markAllNotificationsAsRead }
mutation { deleteNotification(id: "notif_123") }

Settings

mutation { updateUserSetting(key: "theme", value: "dark") { key value } }
mutation { deleteUserSetting(key: "theme") }

Rewards & Withdrawals

mutation { claimReward(reward_id: "rwd_123") { id } }
mutation { createWithdraw(input: { amount: 100, wallet_address: "0x..." }) { id } }
mutation { cancelWithdraw(id: "wd_123") { id } }

Onboarding

mutation { completeOnboarding { success } }
mutation { resetOnboarding { success } }
mutation { trackOnboardingEvent(event: "exchange_connected", stepId: "step1") }

Passkeys

mutation { generatePasskeyRegistrationChallenge { success data { challenge rp { id name } } } }
mutation { registerPasskey(credential: "...", device_name: "MacBook") { success data { id device_name } } }
mutation { generatePasskeyLoginChallenge(email: "[email protected]") { success data { challenge rpId } } }
mutation { loginWithPasskey(credential: "...", recaptcha_token: "token") { accessToken refreshToken } }
mutation { deletePasskey(id: "pk_123") { success } }
mutation { renamePasskey(id: "pk_123", device_name: "Work Laptop") { success } }

Admin Mutations

mutation { updateUserStatus(user_id: "user_123", is_active: false) { id is_active } }
mutation { grantSystemAdmin(user_id: "user_123") { id is_system_admin } }
mutation { revokeSystemAdmin(user_id: "user_123") { id is_system_admin } }
mutation { adminResetUserPassword(user_id: "user_123") { success temporary_password } }
mutation { adminChangeUserEmail(user_id: "user_123", new_email: "[email protected]") { success } }
mutation { adminResetUser2FA(user_id: "user_123") { success } }
mutation { adminDeactivateUser(user_id: "user_123", reason: "TOS violation") { success } }
mutation { adminReactivateUser(user_id: "user_123") { success } }
mutation { adminToggleSystemAdmin(user_id: "user_123", is_admin: true) { success } }
mutation { adminEnableApiKey(key_id: "key_123", type: "rest") { success } }