Update Subscription API

Update user subscription settings including concurrent logins, bandwidth limits, and download/upload quotas

Admin

Update Subscription API

Modify subscription settings for any user. Adjust concurrent login limits, daily bandwidth allowances, and download/upload quotas without changing plans.

Adjust Limits

Modify usage quotas.

Login Count

Change concurrent sessions.

Bandwidth

Set daily data limits.


Endpoint Overview

MUTATION/graphql

Update a user's subscription settings including the number of simultaneous logins allowed, daily bandwidth limits, and download/upload quotas.

Authentication:Bearer Token
Required scopes:admin

Request Parameters

userIdInt!Required

The unique identifier of the user whose subscription is being updated.

multiLoginCountInt!Required

The updated number of simultaneous logins allowed for the user.

dailyBandwidthFloat!Required

The updated daily bandwidth limit in GB (use -1 for unlimited).

downloadUploadFloat

Download/upload speed limit in Mbps (use -1 for unlimited).


GraphQL Mutation

mutation updateSubscription(
  $userId: Int!,
  $multiLoginCount: Int!,
  $dailyBandwidth: Float!,
  $downloadUpload: Float
) {
  updateSubscription(
    userId: $userId,
    multiLoginCount: $multiLoginCount,
    dailyBandwidth: $dailyBandwidth,
    downloadUpload: $downloadUpload
  ) {
    success
    message
  }
}

Variables:

{
  "userId": 12345,
  "multiLoginCount": 5,
  "dailyBandwidth": 10.0,
  "downloadUpload": 100.0
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -d '{
    "query": "mutation updateSubscription($userId: Int!, $multiLoginCount: Int!, $dailyBandwidth: Float!, $downloadUpload: Float) { updateSubscription(userId: $userId, multiLoginCount: $multiLoginCount, dailyBandwidth: $dailyBandwidth, downloadUpload: $downloadUpload) { success message } }",
    "variables": {
      "userId": 12345,
      "multiLoginCount": 5,
      "dailyBandwidth": 10.0,
      "downloadUpload": 100.0
    }
  }'

Response

200Subscription Updated Successfully
{
  "data": {
    "updateSubscription": {
      "success": true,
      "message": "Subscription settings updated successfully"
    }
  }
}
400User Not Found
{
  "errors": [
    {
      "message": "User with ID 12345 not found",
      "path": ["updateSubscription"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}
400Invalid Values
{
  "errors": [
    {
      "message": "multiLoginCount must be a positive integer",
      "path": ["updateSubscription"],
      "extensions": {
        "code": "INVALID_INPUT"
      }
    }
  ],
  "data": null
}

Configurable Settings

Multi-Login

How many devices can connect at once.

Daily Bandwidth

Data usage limit per day in GB.

Speed Limits

Download/upload speed caps in Mbps.

Unlimited Option

Use -1 for no limits on a setting.


Use Cases

Upgrade Access

Give user more concurrent sessions.

Support Request

Temporarily increase limits.

Custom Plans

Create tailored subscription settings.

Abuse Prevention

Reduce limits for policy violations.


Best Practices

Verify User

Confirm user ID exists before updating.

Document Changes

Record reason for modifications.

Notify User

Inform user of limit changes.

Use Sensible Limits

Set appropriate values for plan tier.



Admin Permission Required

This endpoint requires admin-level authentication. Only administrators can modify subscription settings for users.

Need to Reset Instead?

If you want to restore default group settings, use the Reset Subscription endpoint.

Reset Subscription