Edit Reseller API

Update reseller account details including email, phone, and profile information

Reseller Management

Edit Reseller API

Update reseller account information including contact details and profile data. Keep reseller records accurate and up-to-date.

Update Profile

Modify reseller information.

Change Contact

Update email and phone.

Edit Details

Modify names and metadata.


Endpoint Overview

MUTATION/graphql

Update an existing reseller's account details. Only provided fields will be updated.

Authentication:Bearer Token
Required scopes:admin

Request Parameters

idInt!Required

The unique identifier of the reseller to update.

reseller.emailString

Updated email address for the reseller.

reseller.phoneString

Updated phone number.

reseller.firstNameString

Updated first name.

reseller.lastNameString

Updated last name.


GraphQL Mutation

mutation editReseller($id: Int!, $reseller: ResellerEdit!) {
  editReseller(id: $id, reseller: $reseller) {
    id
    email
    firstName
    lastName
    credit
    level
    phone
    updatedAt
  }
}

Variables:

{
  "id": 12345,
  "reseller": {
    "email": "newemail@company.com",
    "phone": "+1987654321",
    "firstName": "Jane",
    "lastName": "Smith"
  }
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -d '{
    "query": "mutation editReseller($id: Int!, $reseller: ResellerEdit!) { editReseller(id: $id, reseller: $reseller) { id email firstName lastName phone } }",
    "variables": {
      "id": 12345,
      "reseller": {
        "email": "newemail@company.com",
        "phone": "+1987654321"
      }
    }
  }'

Response

200Reseller Updated Successfully
{
  "data": {
    "editReseller": {
      "id": "12345",
      "email": "newemail@company.com",
      "firstName": "Jane",
      "lastName": "Smith",
      "credit": "1000",
      "level": "GOLD",
      "phone": "+1987654321",
      "updatedAt": "2024-01-16T14:20:00Z"
    }
  }
}
400Reseller Not Found
{
  "errors": [
    {
      "message": "Reseller with ID 12345 not found",
      "path": ["editReseller"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}
400Email Already In Use
{
  "errors": [
    {
      "message": "Email is already in use by another account",
      "path": ["editReseller"],
      "extensions": {
        "code": "EMAIL_EXISTS"
      }
    }
  ],
  "data": null
}

Editable Fields

Email Address

Update login and notification email.

Phone Number

Change contact phone number.

Name

Update first and last name.

Profile Data

Modify additional profile fields.


Best Practices

Verify Changes

Confirm updates with the reseller.

Validate Email

Ensure new email addresses are valid.

Audit Trail

Track changes for compliance.

Notify Reseller

Inform reseller of account changes.



Partial Updates

Only include fields you want to update. Omitted fields will retain their current values.

Need to Change Credit or Level?

Use dedicated endpoints for credit and level changes to maintain proper audit trails.

Add Credit