Renew Without Group API

Extend user subscription duration without changing group assignment or plan settings

Admin

Renew Without Group API

Extend a user's subscription by adding days without modifying their current group or plan settings. Perfect for time-based renewals.

Add Time

Extend subscription days.

Keep Settings

No group changes needed.

Quick Renewal

Simple one-step process.


Endpoint Overview

MUTATION/graphql

Renew a user's subscription by extending the duration without changing their group assignment. This preserves all current plan settings while adding more time.

Authentication:Bearer Token
Required scopes:admin

Request Parameters

usernameString!Required

The username of the user whose subscription is to be renewed.

daysInt!Required

Number of days to add to the subscription.


GraphQL Mutation

mutation renewWithoutGroup($username: String!, $days: Int!) {
  renewWithoutGroup(username: $username, days: $days) {
    duration
    multiLoginCount
    expiresAt
    createdAt
    updatedAt
    dailyBandwidth
    downloadUpload
  }
}

Variables:

{
  "username": "johndoe",
  "days": 30
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -d '{
    "query": "mutation renewWithoutGroup($username: String!, $days: Int!) { renewWithoutGroup(username: $username, days: $days) { duration expiresAt multiLoginCount } }",
    "variables": {
      "username": "johndoe",
      "days": 30
    }
  }'

Response

200Subscription Renewed Successfully
{
  "data": {
    "renewWithoutGroup": {
      "duration": 60,
      "multiLoginCount": 5,
      "expiresAt": "2024-03-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-02-14T08:00:00Z",
      "dailyBandwidth": "unlimited",
      "downloadUpload": "unlimited"
    }
  }
}
400User Not Found
{
  "errors": [
    {
      "message": "User with username 'johndoe' not found",
      "path": ["renewWithoutGroup"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}
400Invalid Days
{
  "errors": [
    {
      "message": "Days must be a positive integer",
      "path": ["renewWithoutGroup"],
      "extensions": {
        "code": "INVALID_INPUT"
      }
    }
  ],
  "data": null
}

When to Use

Manual Renewal

Admin-initiated subscription extension.

Compensation

Add days for service issues.

Promotions

Bonus days for loyal customers.

Grace Period

Extend during payment processing.


Best Practices

Verify Username

Confirm user exists before renewal.

Appropriate Duration

Add sensible number of days.

Document Reason

Record why extension was granted.

Notify User

Inform user of extended subscription.



Settings Preserved

This endpoint only extends the subscription duration. All other settings including login count, bandwidth limits, and group assignment remain unchanged.

Need to Change the Plan?

If you need to renew with different plan settings, use the Reset with New Group endpoint.

Reset with New Group