Admin

Get all admin users of the contract

get

You can retrieve a complete list of admin users of the contract

Authorizations

BasicAuthenticationTokenAuthentication

AuthorizationstringRequired

You will need to base64 encode the string containing your credentials. Note:

Path parameters

contractNumberinteger · int64Required

Responses

200

Success

application/json

idstringRead-onlyOptional

The resource's unique identifier

Example: 15514

hrefstring · uriRead-onlyOptional

URI for specific Admin in a Contract

Example: https://api.ionos.com/reseller/v2/contract/15514/admin/5533

firstNamestringRead-onlyOptional

first name of the user

lastNamestringRead-onlyOptional

last name of the user

emailstringRead-onlyOptional

email of the user

default

Any erroneous status code: 400 (parse error), 401 (auth error), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).

application/json

get

/contracts/{contractNumber}/admins

HTTPcURLJavaScriptPython

GET /reseller/v2/contracts/{contractNumber}/admins HTTP/1.1
Authorization: Basic username:password
Accept: */*

[
  {
    "id": "15514",
    "href": "https://api.ionos.com/reseller/v2/contract/15514/admin/5533",
    "firstName": "text",
    "lastName": "text",
    "email": "text"
  }
]

Create new admin user for contract

post

Authorizations

BasicAuthenticationTokenAuthentication

AuthorizationstringRequired

You will need to base64 encode the string containing your credentials. Note:

Path parameters

contractNumberinteger · int64Required

Body

application/json

firstNamestringRequired

first name of the user

lastNamestringRequired

last name of the user

emailstringRequired

email of the user

passwordstringRequired

password of the user

Responses

201

Success

application/json

default

Any erroneous status code: 400 (parse error), 401 (auth error), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).

application/json

post

/contracts/{contractNumber}/admins

HTTPcURLJavaScriptPython

POST /reseller/v2/contracts/{contractNumber}/admins HTTP/1.1
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "firstName": "text",
  "lastName": "text",
  "email": "text",
  "password": "text"
}

{
  "id": "15514",
  "href": "https://api.ionos.com/reseller/v2/contract/15514/admin/5533",
  "firstName": "text",
  "lastName": "text",
  "email": "text"
}

Find admin by ID

get

Authorizations

BasicAuthenticationTokenAuthentication

AuthorizationstringRequired

You will need to base64 encode the string containing your credentials. Note:

Path parameters

contractNumberinteger · int64Required

adminIdinteger · int64Required

Responses

200

Success

application/json

idstringRead-onlyOptional

The resource's unique identifier

Example: 15514

hrefstring · uriRead-onlyOptional

URI for specific Admin in a Contract

Example: https://api.ionos.com/reseller/v2/contract/15514/admin/5533

firstNamestringRead-onlyOptional

first name of the user

lastNamestringRead-onlyOptional

last name of the user

emailstringRead-onlyOptional

email of the user

default

Any erroneous status code: 400 (parse error), 401 (auth error), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).

application/json

get

/contracts/{contractNumber}/admins/{adminId}

HTTPcURLJavaScriptPython

GET /reseller/v2/contracts/{contractNumber}/admins/{adminId} HTTP/1.1
Authorization: Basic username:password
Accept: */*

{
  "id": "15514",
  "href": "https://api.ionos.com/reseller/v2/contract/15514/admin/5533",
  "firstName": "text",
  "lastName": "text",
  "email": "text"
}

Delete admin user

delete

This method call will remove admin user from the contract. This is a highly destructive method and must be used with caution.

Authorizations

BasicAuthenticationTokenAuthentication

AuthorizationstringRequired

You will need to base64 encode the string containing your credentials. Note:

Path parameters

contractNumberinteger · int64Required

adminIdinteger · int64Required

Responses

204

Success

application/json

default

Any erroneous status code: 400 (parse error), 401 (auth error), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).

application/json

delete

/contracts/{contractNumber}/admins/{adminId}

HTTPcURLJavaScriptPython

DELETE /reseller/v2/contracts/{contractNumber}/admins/{adminId} HTTP/1.1
Authorization: Basic username:password
Accept: */*

{}

Partially update admin user

patch

You can use this method to partially update admin user properties (firstName and/or lastName and/or email)

Authorizations

BasicAuthenticationTokenAuthentication

AuthorizationstringRequired

You will need to base64 encode the string containing your credentials. Note:

Path parameters

contractNumberinteger · int64Required

adminIdinteger · int64Required

Body

application/json

firstNamestringRequired

first name of the user

lastNamestringRequired

last name of the user

emailstringRequired

email of the user

Responses

200

Success

application/json

idstringRead-onlyOptional

The resource's unique identifier

Example: 15514

hrefstring · uriRead-onlyOptional

URI for specific Admin in a Contract

Example: https://api.ionos.com/reseller/v2/contract/15514/admin/5533

firstNamestringRead-onlyOptional

first name of the user

lastNamestringRead-onlyOptional

last name of the user

emailstringRead-onlyOptional

email of the user

default

Any erroneous status code: 400 (parse error), 401 (auth error), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).

application/json

patch

/contracts/{contractNumber}/admins/{adminId}

HTTPcURLJavaScriptPython

PATCH /reseller/v2/contracts/{contractNumber}/admins/{adminId} HTTP/1.1
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "firstName": "text",
  "lastName": "text",
  "email": "text"
}

{
  "id": "15514",
  "href": "https://api.ionos.com/reseller/v2/contract/15514/admin/5533",
  "firstName": "text",
  "lastName": "text",
  "email": "text"
}