General

OpenAPI documentation for the i3D.net API.

Get the data usage for a uplinkId in a cross connect, by default, past 24 hours

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired

The Id of the cross connect

uplinkIdintegerRequired

The Id of the uplink

Query parameters
startTimeintegerOptional

Start unix timestamp

endTimeintegerOptional

End unix timestamp

Responses
chevron-right
200

OK

application/json
unitstringRead-onlyRequired

Unit of data frequency, possible interval options are as follows

  • day
get
/v3/telemetry/crossConnect/{crossConnectId}/usage/{uplinkId}/raw

Gets the network telemetry for a given colocation on hourly basis (default = last 24 hours)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired
Query parameters
startTimeintegerOptional

Start unix timestamp

endTimeintegerOptional

End unix timestamp

Responses
chevron-right
200

OK

application/json
unitstringRead-onlyRequired

Unit of data frequency (hour by default)

get
/v3/telemetry/colocation/{colocationId}/network

Get the history list of power usage for all colocation

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
startTimeintegerOptional

Unix timestamp. Filter from time, default value is -1 day

endTimeintegerOptional

Unix timestamp. Filter to time, default value is now

Responses
chevron-right
200

OK

application/json
unitstringRead-onlyRequired

Unit of data frequency, which is always null in this endpoint. This property is there for consistency across all telemetry endpoints. It's null because the data is not aggregated

get
/v3/telemetry/colocation/powerUsage

Get the list of all colocation current power usage

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringRequired

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of the colocation service

namestringRead-onlyRequired

The name of the colocation service

kwhinteger · integerRead-onlyRequired

Current month kilo watts per hour

get
/v3/telemetry/colocation/powerUsage/current
Deprecated

Get the history list of power usage for a colocation and pdu

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired
pduIdintegerRequired
Query parameters
startTimeintegerOptional

Unix timestamp. Filter from time, default value is -1 day

endTimeintegerOptional

Unix timestamp. Filter to time, default value is now

Header parameters
RANGED-DATAstringRequired

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
timestampinteger · integerRead-onlyRequired

The time at which the last update occurred

ampsnumber · floatRead-onlyRequired

The value of amps at that time

voltsnumber · floatRead-onlyRequired

The value of volts at that time

kwhnumber · floatRead-onlyRequired

The value of kwh at that time

powerMeterinteger · integerRead-onlyRequired

The value of power meter at that time

get
/v3/telemetry/colocation/{colocationId}/pdu/{pduId}

List of overuse host

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringRequired

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
coloIdinteger · integerRead-onlyRequired

The ID of the colocation

coloNamestringRead-onlyRequired

The name of the colocation

orderedBandwidthnumber · floatRead-onlyRequired

Allowed bandwidth of the host

usedBandwidthnumber · floatRead-onlyRequired

Used bandwidth of the host

get
/v3/telemetry/colocation/overuse/current

Get the history list of power usage for a pdu

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
pduIdintegerRequired
Query parameters
startTimeintegerOptional

Unix timestamp. Filter from time, default value is -1 day

endTimeintegerOptional

Unix timestamp. Filter to time, default value is now

Responses
chevron-right
200

OK

application/json
unitstringRead-onlyRequired

Unit of data frequency, which is always null in this endpoint. This property is there for consistency across all telemetry endpoints. It's null because the data is not aggregated

get
/v3/telemetry/pdu/{pduId}

Get health of the API

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
statusstringRequired

Status - either OK or FAIL

get
/v3/health

Get basic details of the logged in user

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
userIdinteger · integerRequired

Your user ID

userNamestringRequired

Your user name

emailstringRequired

Email

firstNamestringRequired

First name

lastNamestringRequired

Last name

genderstringRequired

User gender

phonestringRequired

Phone number

accessLevelinteger · integerRequired

0: Guest, 10: Regular logged in user, 20: Game Hosting management access

validateEmailinteger · integerRead-onlyRequired

Whether or not user email is validated

isTrialAccountinteger · integerRead-onlyRequired

Whether or not user is trial account

trialAccountExpirationDatestringRead-onlyRequired

The expiration date of the trial account

requestIpstringRequired

Request IP address

requestIpCountrystringRequired

The GeoLocation country (ISO 3166) of the request IP address

requestIpCountryCodestringRequired

The GeoLocation country code (ISO 3166 Alpha-2) of the request IP address

get
/v3/session/user

Log in

post
Authorizations
PRIVATE-TOKENstringRequired
Body
userNamestringRequired

User name

passwordstringRequired

Password

rememberMeinteger · integerOptional

Remember me

Responses
chevron-right
200

OK

application/json
requiresOtpbooleanRequired

Indicates whether a 2FA One-Time Password token is required to complete the login.

expiresAtinteger · integerRequired

Unix timestamp indicating when the window for 2FA authentication closes, 0 if not applicable.

otpSessionExpiresAtinteger · integerRequired

If 2FA is active on your account, you must supply the one-time-password before this unix timestamp expires.

post
/v3/session/login

Provide 2FA One-Time Password after a successful login (if requiresOtp is true in SessionAuthReq, as returned by /session/login)

post
Authorizations
PRIVATE-TOKENstringRequired
Body
otpstringRequired

6 digit One-Time Password

Responses
post
/v3/session/login/otp

No content

Log out

post
Authorizations
PRIVATE-TOKENstringRequired
Responses
post
/v3/session/logout

No content

Request the VAT percentage for a shop category, for your specific user

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
serviceNamestringRequired
Body
taxPercentnumber · floatRequired

VAT percentage

Responses
chevron-right
200

OK

No content

get
/v3/calc/utilities/servicevatpercentage/{serviceName}

No content

Request the user / reseller group margin factors for a calc category

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
categoryNamestringRequired
Body
resellerTypeIdinteger · integerRequired

ID of a reseller type

resellerTypeNamestringRequired

Name of a reseller type

categoryIdinteger · integerRequired

ID of the category

marginFactornumber · floatRequired

ID of a category

Responses
chevron-right
200

OK

No content

get
/v3/calc/utilities/marginfactors/{categoryName}

No content

Get all shop categories

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

ID of a category

namestringRequired

Name of a category

get
/v3/calc/categories

Get all configurations for the given shop category

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
categoryNamestringRequired

Category name, one of /calc/categories

Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

ApplicationInstanceConfiguration ID

taginteger · integerRequired

ApplicationInstanceConfiguration tag

locationIdinteger · integerRequired

Location ID, as provided by /locations

priceinteger · integerRequired

ApplicationInstanceConfiguration price in cents

setupinteger · integerRequired

ApplicationInstanceConfiguration setup price in cents

flagsinteger · integerRequired

ApplicationInstanceConfiguration flags IMMUTABLE 1; INSTANT_CONFIG 2; ALLOW_DOWNGRADE 4; IS_DEAL 8; ON_DEAL_PAGE 16; COLO_NO_CONN 32; PRIVATE_CONFIG 64;

bwPriceDediinteger · integerRequired

TB price for dedicated servers, in cents

bwPriceColointeger · integerRequired

TB price for colocation, in cents

fixedbooleanRequired

Whether this configuration is adjustable

noDowngradebooleanRequired

Whether items in this configuration can be downgraded

instantDeliverablebooleanRequired

Whether this configuration can be setup instantly and automatically (low wait time)

get
/v3/calc/configs/{categoryName}

Get all groups and items of the given category

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
categoryNamestringRequired

Category name, one of /calc/categories

Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

ApplicationInstanceConfiguration group ID

namestringRequired

ApplicationInstanceConfiguration group name

codestringRequired

ApplicationInstanceConfiguration group code

typestringRequired

ApplicationInstanceConfiguration group type (a human readable unique identifier)

fixedbooleanRequired

Whether items in this configuration group are adjustable

stepinteger · integerRequired

ApplicationInstanceConfiguration group divider (for visual differentiation between related groups)

flagsinteger · integerRequired

FLAG_HASQUANTITY 1 FLAG_HASPRICE 2 FLAG_ALLOW_EMPTY_SELECTION 4 FLAG_INCLUDE_ON_INVOICE_IF_EMPTY 8 FLAG_NOTE_ACTIVE 16 FLAG_APPLY_PERIOD_DISCOUNT 32 FLAG_EXCLUDE_FROM_UPGRADES 64

noDowngradebooleanRequired

Whether items in this configuration group can be downgraded

displayOrderinteger · integerRequired

ApplicationInstanceConfiguration group display order

dependencyGroupIdinteger · integerRequired

If > 0, this group will only relevant / shown if the dependency group and/or item is selected.

dependencyItemIdsinteger · integer[]Required

If dependencyGroupId > 0, this group will only relevant / shown if (one of) these dependencyItemIds are selected.

notesstringRequired

Optional notes for a group, for displaying purposes.

defaultItemIdinteger · integerRequired

Default item in a group

get
/v3/calc/items/{categoryName}

Get all the availability locations per calc category

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
categoryIdsinteger · integer[]Required

Category IDs

locationIdinteger · integerRequired

Location ID

countryNamestringRequired

Name of the country of this location

countryNameShortstringRequired

Name of the country of this location

regionIdinteger · integerRequired

Region ID

regionNamestringRequired

Name of the region this location is situated in (regions are smaller than continents, but may be a whole continent).

continentstringRequired

Name of the continent of this location

citystringRequired

Name of the city of this location

locationBwPriceDediinteger · integerRequired

Dedicated server bandwidth price per TB for this location, in cents

locationBwOverusePriceDediinteger · integerRequired

Dedicated server bandwidth overuse price per TB for this location, in cents

locationBwPriceColointeger · integerRequired

Colocation bandwidth price per TB for this location, in cents

locationBwOverusePriceColointeger · integerRequired

Colocation bandwidth overuse price per TB for this location, in cents

get
/v3/calc/locations

Get all order IDs (and meta data) from your cart

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

Order ID

finalizedbooleanRequired

True if an order has been added to the cart.

instantDeliverablebooleanRequired

Whether this order is instantly deliverable (normally speaking)

get
/v3/calc/orders

Create an order from a config (tag)

post
Authorizations
PRIVATE-TOKENstringRequired
Body
configTagstringRequired

Configuration tag to create an order from.

couponTagstringRequired

Coupon tag to apply to the order.

instantFinalizebooleanRequired

Whether you want to immediately make the order available for checkout.

Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

Order ID

finalizedbooleanRequired

Whether the order has been added to your cart.

createdAtinteger · integerRequired

Order creation unix timestamp

modifiedAtinteger · integerRequired

Order last modification unix timestamp

quantityinteger · integerRequired

Order quantity multiplier

titlestringRequired

Order title

categoryIdinteger · integerRequired

Order shop category ID

categoryNamestringRequired

Order shop category name

configTagstringRequired

The tag of the configuration this order is based upon.

configNamestringRequired

The name of the configuration this order is based upon.

configFlagsinteger · integerRequired

ApplicationInstanceConfiguration flags IMMUTABLE 1; INSTANT_CONFIG 2; ALLOW_DOWNGRADE 4; IS_DEAL 8; ON_DEAL_PAGE 16; COLO_NO_CONN 32; PRIVATE_CONFIG 64;

instantDeliverablebooleanRequired

Whether this configuration can be setup instantly and automatically (low wait time)

priceinteger · integerRequired

Order price in cents

setupinteger · integerRequired

Order setup price in cents

vatinteger · integerRequired

Order VAT in cents

vatPercentagenumber · floatRequired

Order VAT percentage

post
/v3/calc/orders

Submit a quote request for your current cart

post
Authorizations
PRIVATE-TOKENstringRequired
Body
userIdinteger · integerOptional

Customer's user ID

firstNamestring · min: 2 · max: 64Required

Customer's first name

lastNamestring · min: 2 · max: 128Required

Customer's last name

companyNamestring · max: 120Optional

Customer's company name (optional)

emailstring · max: 128Required

Customer's email address

phonestring · min: 5 · max: 15Required

Customer's phone number

remarksstring · max: 4000Optional

Remarks contain specific question(s) regarding the quote

Responses
chevron-right
200

OK

No content

post
/v3/calc/orders/quote

No content

Get an order from the cart

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
orderIdintegerRequired

Order ID

Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

Order ID

finalizedbooleanRequired

Whether the order has been added to your cart.

createdAtinteger · integerRequired

Order creation unix timestamp

modifiedAtinteger · integerRequired

Order last modification unix timestamp

quantityinteger · integerRequired

Order quantity multiplier

titlestringRequired

Order title

categoryIdinteger · integerRequired

Order shop category ID

categoryNamestringRequired

Order shop category name

configTagstringRequired

The tag of the configuration this order is based upon.

configNamestringRequired

The name of the configuration this order is based upon.

configFlagsinteger · integerRequired

ApplicationInstanceConfiguration flags IMMUTABLE 1; INSTANT_CONFIG 2; ALLOW_DOWNGRADE 4; IS_DEAL 8; ON_DEAL_PAGE 16; COLO_NO_CONN 32; PRIVATE_CONFIG 64;

instantDeliverablebooleanRequired

Whether this configuration can be setup instantly and automatically (low wait time)

priceinteger · integerRequired

Order price in cents

setupinteger · integerRequired

Order setup price in cents

vatinteger · integerRequired

Order VAT in cents

vatPercentagenumber · floatRequired

Order VAT percentage

get
/v3/calc/orders/{orderId}

Update an order

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
orderIdintegerRequired

Order ID

Body
quantityinteger · integerRequired

Order quantity

Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

Order ID

finalizedbooleanRequired

Whether the order has been added to your cart.

createdAtinteger · integerRequired

Order creation unix timestamp

modifiedAtinteger · integerRequired

Order last modification unix timestamp

quantityinteger · integerRequired

Order quantity multiplier

titlestringRequired

Order title

categoryIdinteger · integerRequired

Order shop category ID

categoryNamestringRequired

Order shop category name

configTagstringRequired

The tag of the configuration this order is based upon.

configNamestringRequired

The name of the configuration this order is based upon.

configFlagsinteger · integerRequired

ApplicationInstanceConfiguration flags IMMUTABLE 1; INSTANT_CONFIG 2; ALLOW_DOWNGRADE 4; IS_DEAL 8; ON_DEAL_PAGE 16; COLO_NO_CONN 32; PRIVATE_CONFIG 64;

instantDeliverablebooleanRequired

Whether this configuration can be setup instantly and automatically (low wait time)

priceinteger · integerRequired

Order price in cents

setupinteger · integerRequired

Order setup price in cents

vatinteger · integerRequired

Order VAT in cents

vatPercentagenumber · floatRequired

Order VAT percentage

put
/v3/calc/orders/{orderId}

Delete an order from the cart

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
orderIdintegerRequired

Order ID

Responses
delete
/v3/calc/orders/{orderId}

No content

Set an order in the cart to "checkout" (which means it will show up on the checkout page). Updating the order is still allowed after finalization

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
orderIdintegerRequired

Order ID

Responses
put
/v3/calc/orders/finalize/{orderId}

No content

Get all jobs

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

ID of the job

slugstringRequired

Title in url format

titlestringRequired

Job title

headerImagestringRequired

Image to display as the header for the job details page

tileImagestringRequired

Image to use on the over view page for this job

introTextstringRequired

Job introductory text

textstringRequired

Job description text

intakeDateinteger · integerRequired

Unix timestamp of the (final) intake date

get
/v3/jobs

Get the details of a job

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
jobIdintegerRequired

The Id of the jobs you are requesting

Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

ID of the job

slugstringRequired

Title in url format

titlestringRequired

Job title

headerImagestringRequired

Image to display as the header for the job details page

tileImagestringRequired

Image to use on the over view page for this job

introTextstringRequired

Job introductory text

textstringRequired

Job description text

intakeDateinteger · integerRequired

Unix timestamp of the (final) intake date

get
/v3/jobs/{jobId}

Solicit for a job

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
jobIdintegerRequired

The Id of the jobs you are soliciting for

Responses
chevron-right
200

OK

No content

post
/v3/jobs/{jobId}/solicit

No content

Add files to the solicitation

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
jobIdintegerRequired

The Id of the jobs you are soliciting for

solicitIdintegerRequired

The Id of the solicitation you are uploading files for

Responses
chevron-right
200

OK

No content

post
/v3/jobs/{jobId}/solicit/{solicitId}/files

No content

Get user remote information

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
ipAddressFromServerVariablestringRequired

The ip address for which you wish to fetch the data

ipAddressFromRequeststringRequired

The ip address for which you wish to fetch the data

xForwardForstringRead-onlyRequired

The xForwardFor for which you wish to fetch the data

xForwardHoststringRead-onlyRequired

The xForwardHost for which you wish to fetch the data

userAgentstringRequired

The user agent for which you wish to fetch the data

get
/v3/user/getUserRemoteInfo

Sign up for the newsletter. This will send a confirmation email with a validation url to follow.

post
Authorizations
PRIVATE-TOKENstringRequired
Body
emailstring · max: 128Required

Customer's email address

languagestringRequired

Customer's preferred language

Responses
post
/v3/newsletter/optin

No content

Newsletter sign up confirmation, with the token from the confirmation email.

post
Authorizations
PRIVATE-TOKENstringRequired
Body
tokenstring · uuidRequired

The confirmation token from the opt-in email.

Responses
post
/v3/newsletter/confirm

No content

Unsubscribe from the newsletter, using the unsubscribe url in a newsletter.

post
Authorizations
PRIVATE-TOKENstringRequired
Body
mailhashstringRequired

A hash, as provided in the newsletter unsubscribe url

keystringRequired

A key, as provided in the newsletter unsubscribe url

Responses
post
/v3/newsletter/unsubscribe

No content

Request a colocation quote

post
Authorizations
PRIVATE-TOKENstringRequired
Body
firstNamestring · min: 2 · max: 64Required

Customer's first name

lastNamestring · min: 2 · max: 128Required

Customer's last name

companyNamestring · max: 120Optional

Customer's company name (optional)

emailstring · max: 128Required

Customer's email address

phonestring · min: 5 · max: 15Required

Customer's phone number

rackstringRequired

Rack space volume of interest

locationstringRequired

Location of interest

remarksstringRequired

Quote remarks (the actual question and additional details)

Responses
post
/v3/colocation/quote

No content

Get a list of all ticket categories

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
string[]Optional
get
/v3/tickets/categories

Get a list of all ticket meta data (no actual contents)

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerOptional

Ticket ID

hashstringOptional

Ticket hash

readHashstringOptional

Ticket read hash

titlestringRequired

Ticket title

categoryNamestringRequired

Ticket category name

priorityNamestringOptional

Ticket priority name

createdAtinteger · integerOptional

Ticket creation unix timestamp

updatedAtinteger · integerOptional

Ticket last update unix timestamp

clientLastRepliedAtinteger · integerOptional

Time at which the client last replied to the ticket

clientLastReadAtinteger · integerOptional

Time at which the client last read the ticket

statusstringRequired

Ticket status

numUserRepliesinteger · integerOptional

Number of replies in ticket

get
/v3/tickets

Create a new ticket

post
Authorizations
PRIVATE-TOKENstringRequired
Body
titlestringRequired

Ticket title

contentstringRequired

Ticket content

categorystringRequired

Ticket category name, must be one of GET /v3/tickets/categories

departmentstringRequired

Ticket department name

emailCcstringRequired

Ticket's "Carbon Copy" email addresses in CSV format

emailTostringRequired

Ticket's destination email addresses in CSV format

attachmentIdsinteger · integer[]Optional

The IDs of attachments that have been uploaded through POST /v3/tickets/attachment

Responses
chevron-right
200

OK

application/json
idinteger · integerOptional

Ticket ID

hashstringOptional

Ticket hash

readHashstringOptional

Ticket read hash

titlestringRequired

Ticket title

categoryNamestringRequired

Ticket category name

priorityNamestringOptional

Ticket priority name

createdAtinteger · integerOptional

Ticket creation unix timestamp

updatedAtinteger · integerOptional

Ticket last update unix timestamp

clientLastRepliedAtinteger · integerOptional

Time at which the client last replied to the ticket

clientLastReadAtinteger · integerOptional

Time at which the client last read the ticket

statusstringRequired

Ticket status

numUserRepliesinteger · integerOptional

Number of replies in ticket

post
/v3/tickets

Get a list of all ticket meta data (no actual contents) that are open or unread

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerOptional

Ticket ID

hashstringOptional

Ticket hash

readHashstringOptional

Ticket read hash

titlestringRequired

Ticket title

categoryNamestringRequired

Ticket category name

priorityNamestringOptional

Ticket priority name

createdAtinteger · integerOptional

Ticket creation unix timestamp

updatedAtinteger · integerOptional

Ticket last update unix timestamp

clientLastRepliedAtinteger · integerOptional

Time at which the client last replied to the ticket

clientLastReadAtinteger · integerOptional

Time at which the client last read the ticket

statusstringRequired

Ticket status

numUserRepliesinteger · integerOptional

Number of replies in ticket

get
/v3/tickets/openOrUnread

Get a specific ticket with all replies.

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
ticketIdintegerRequired

Ticket ID

Responses
chevron-right
200

OK

application/json
idinteger · integerOptional

Ticket ID

hashstringOptional

Ticket hash

readHashstringOptional

Ticket read hash

titlestringRequired

Ticket title

categoryNamestringRequired

Ticket category name

priorityNamestringOptional

Ticket priority name

createdAtinteger · integerOptional

Ticket creation unix timestamp

updatedAtinteger · integerOptional

Ticket last update unix timestamp

clientLastRepliedAtinteger · integerOptional

Time at which the client last replied to the ticket

clientLastReadAtinteger · integerOptional

Time at which the client last read the ticket

statusstringRequired

Ticket status

numUserRepliesinteger · integerOptional

Number of replies in ticket

get
/v3/tickets/{ticketId}

Get a ticket attachment

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
ticketIdintegerRequired

Ticket ID

attachmentIdintegerRequired

Attachment ID

Responses
chevron-right
200

OK

application/json
stringOptional
get
/v3/tickets/{ticketId}/attachment/{attachmentId}

Create a new ticket without being logged in (public contact form)

post
Authorizations
PRIVATE-TOKENstringRequired
Body
firstNamestring · min: 2 · max: 64Required

Contact first name

lastNamestring · min: 2 · max: 128Required

Contact last name

companyNamestring · max: 120Optional

Customer's company name (optional)

emailstring · max: 128Required

Contact email address

phonestring · min: 5 · max: 15Required

Contact phone number

titlestring · min: 2 · max: 250Required

Ticket title

contentstringOptional

Ticket content

categorystringRequired

Ticket category name, must be one of GET /v3/tickets/categories

Responses
chevron-right
200

OK

application/json
idinteger · integerOptional

Ticket ID

hashstringOptional

Ticket hash

readHashstringOptional

Ticket read hash

titlestringRequired

Ticket title

categoryNamestringRequired

Ticket category name

priorityNamestringOptional

Ticket priority name

createdAtinteger · integerOptional

Ticket creation unix timestamp

updatedAtinteger · integerOptional

Ticket last update unix timestamp

clientLastRepliedAtinteger · integerOptional

Time at which the client last replied to the ticket

clientLastReadAtinteger · integerOptional

Time at which the client last read the ticket

statusstringRequired

Ticket status

numUserRepliesinteger · integerOptional

Number of replies in ticket

post
/v3/tickets/contact

Post a reply to an existing ticket

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
ticketIdintegerRequired

Ticket ID

Body
titlestringRequired

Reply title

contentstringRequired

Reply content

attachmentIdsinteger · integer[]Optional

The IDs of attachments that have been uploaded through POST /v3/tickets/attachment

Responses
chevron-right
200

OK

application/json
idinteger · integerOptional

Ticket ID

hashstringOptional

Ticket hash

readHashstringOptional

Ticket read hash

titlestringRequired

Ticket title

categoryNamestringRequired

Ticket category name

priorityNamestringOptional

Ticket priority name

createdAtinteger · integerOptional

Ticket creation unix timestamp

updatedAtinteger · integerOptional

Ticket last update unix timestamp

clientLastRepliedAtinteger · integerOptional

Time at which the client last replied to the ticket

clientLastReadAtinteger · integerOptional

Time at which the client last read the ticket

statusstringRequired

Ticket status

numUserRepliesinteger · integerOptional

Number of replies in ticket

post
/v3/tickets/{ticketId}/reply

Upload an attachment to the system

post
Authorizations
PRIVATE-TOKENstringRequired
Body
attachmentobjectRequired

The attachment that is uploaded through your multipart/form-data request.

Responses
chevron-right
200

OK

application/json
attachmentIdinteger · integerRequired

The ID of the attachment that was uploaded through your multipart/form-data request.

post
/v3/tickets/attachment

Delete an attachment *that is not coupled to a ticket or reply yet*

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
attachmentIdintegerRequired

Attachment ID

Responses
delete
/v3/tickets/attachment/{attachmentId}

No content

Open a ticket (if it isn't force-closed)

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
ticketIdintegerRequired

Ticket ID

Responses
put
/v3/tickets/{ticketId}/open

No content

Close a ticket

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
ticketIdintegerRequired

Ticket ID

Responses
put
/v3/tickets/{ticketId}/close

No content

Get all your dedicated servers (can be bare metal servers or VMs) and their main details

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
labelsstringOptional

Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded. E.g.
region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/dedicatedServer?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam"
Warning: the labels query parameter is ignored when passing a PAGE-TOKEN and the original labels string will be used for that request instead.
For more information about labels check details

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of this host

userIdinteger · integerRead-onlyRequired

The ID of the user who owns this server

serverIdinteger · integerRead-onlyRequired

The ID of the physical machine

serverNamestringRead-onlyRequired

The name of the physical machine

serverTypeinteger · integerRead-onlyRequired

The type of the server:

  • 1: Bare metal server
  • 2: Flex metal server
  • 3: Virtual machine
projectNamestringOptional

The name of the project for the host

clientServerNamestringOptional

The name of the server defined by client

clientStatestringOptional

Client statement for the host

liveHostNamestringRead-onlyRequired

The host name

isVirtualinteger · integerRead-onlyRequiredDeprecated

0 if this is a bare metal server, 1 if it's a VM. Use serverType instead

categorystringRead-onlyRequired

Host category. Normally "Dedicated Game Servers" or "Dedicated Servers", but can be "Broken" if the server is in a degraded state

osIdinteger · integerRead-onlyRequired

Operating system ID, must be one of GET /v3/operatingsystem

locationIdinteger · integerRead-onlyRequired

Legacy location ID (not used for ODP)

dcLocationIdinteger · integerRead-onlyRequired

Datacenter location ID. Points to one of GET /v3/cloud/dcLocation

instanceTypestringRead-onlyRequired

The instance type of this server, which is one of GET /v3/host/instanceType for a bare metal, or one of GET /v3/cloud/instanceType for a virtual machine

fleetIdstringRead-onlyRequired

The fleet ID, if this host has been assigned to a fleet If 0, the host has not been assigned to a fleet, otherwise, the fleet is assigned to this host and the host can serve application instances for that fleet.

newFleetIdstring · nullableRead-onlyRequired

The ID of a new fleet that is to be assigned to this host after performing a bulkReserve operation at POST /v3/fleet/host/bulkReserve

fleetAssociatedSinceinteger · integerRead-onlyRequired

Unix timestamp when fleet assigned to the host

rackNamestringRead-onlyRequired

The name of the rack the host is located

dateStartstringRead-onlyRequired

The date at which this host became active

dateEndstringRead-onlyRequired

The date at which this host will expire

dateCancelledstringRead-onlyRequired

The date at which this host was cancelled

dateEndContractstringRead-onlyRequired

The date at which the contract ends (if applicable)

contractPeriodinteger · integerRead-onlyRequired

The contract period in months

extendPeriodinteger · integerRead-onlyRequired

The service extend period in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringRead-onlyRequired

Purchase order, if one has been supplied via our billing department

paymentTerminteger · integerRead-onlyRequired

The payment term in days (how many days are invoices generated before dateEnd)

pricePerMonthstringRead-onlyRequired

The price of this host per month in cents (see currencyId for currency)

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency of the pricePerMonth field:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

brandstringRead-onlyRequired

The server manufacturer brand name

modelstringRead-onlyRequired

The model of the server

numCpuinteger · integerRead-onlyRequired

Number of CPUs in this host

cpuInfostringRead-onlyRequired
cpuTypestringRead-onlyRequired
cpuLoadnumber · floatRead-onlyRequired

Percentage of cpu used across all cores

memUsedinteger · integerRead-onlyRequired

The amount of memory that is used by the host (in megabytes)

memMaxinteger · integerRead-onlyRequired

The amount of memory that is available on the host (in megabytes)

memFreeinteger · integerRead-onlyRequired

The amount of free memory that is available on the host (in megabytes)

isReserveinteger · integerRead-onlyRequired

If the host is reserved for a fleet isReserve set to 1

serviceTagstringRead-onlyRequired

The service tag of the host

isODPinteger · integerRead-onlyRequired

If the host is available for game hosting platform isODP set to 1

fmOrderIdstring · nullableRead-onlyRequired

ID of Flex Metal order if this is a flex metal server

installStatusstring · nullableRead-onlyRequired

Status of server auto install if it was started by one. (created / installing / finished / failed)

statusstringRead-onlyRequired

Whether the host is running or not

uptimeinteger · integerOptional

The uptime of the host. Read-only. Only provided if the server checked-in recently

trafficSuminteger · integerRead-onlyRequired

Monthly traffic of all incoming and outgoing bandwidth in GB or Mbit depending on host configuration

freeIncomingTrafficbooleanRead-onlyRequired

Whether the host has free incoming traffic or not

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

get
/v3/dedicatedServer

Get all your dedicated servers (can be bare metal servers or VMs) and their main details

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
fieldsstringOptional

Fields return in response, only fields available in model can be filter out

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of this host

serverIdinteger · integerRead-onlyRequired

The ID of the physical machine

serverNamestringRead-onlyRequired

The name of the physical machine

serverTypeinteger · integerRead-onlyRequired

The type of the server:

  • 1: Bare metal server
  • 2: Flex metal server
  • 3: Virtual machine
projectNamestringOptional

The name of the project for the host

clientServerNamestringOptional

The name of the server defined by client

clientStatestringOptional

Client statement for the host

liveHostNamestringRead-onlyRequired

The host name

isVirtualinteger · integerRead-onlyRequiredDeprecated

0 if this is a bare metal server, 1 if it's a VM. Use serverType instead

categorystringRead-onlyRequired

Host category. Normally "Dedicated Game Servers" or "Dedicated Servers", but can be "Broken" if the server is in a degraded state

osIdinteger · integerRead-onlyRequired

Operating system ID, must be one of GET /v3/operatingsystem

locationIdinteger · integerRead-onlyRequired

Legacy location ID (not used for ODP)

dcLocationIdinteger · integerRead-onlyRequired

Datacenter location ID. Points to one of GET /v3/cloud/dcLocation

instanceTypestringRead-onlyRequired

The instance type of this server, which is one of GET /v3/host/instanceType for a bare metal, or one of GET /v3/cloud/instanceType for a virtual machine

fleetIdstringRead-onlyRequired

The fleet ID, if this host has been assigned to a fleet If 0, the host has not been assigned to a fleet, otherwise, the fleet is assigned to this host and the host can serve application instances for that fleet.

newFleetIdstring · nullableRead-onlyRequired

The ID of a new fleet that is to be assigned to this host after performing a bulkReserve operation at POST /v3/fleet/host/bulkReserve

fleetAssociatedSinceinteger · integerRead-onlyRequired

Unix timestamp when fleet assigned to the host

rackNamestringRead-onlyRequired

The name of the rack the host is located

dateStartstringRead-onlyRequired

The date at which this host became active

dateEndstringRead-onlyRequired

The date at which this host will expire

dateCancelledstringRead-onlyRequired

The date at which this host was cancelled

dateEndContractstringRead-onlyRequired

The date at which the contract ends (if applicable)

contractPeriodinteger · integerRead-onlyRequired

The contract period in months

extendPeriodinteger · integerRead-onlyRequired

The service extend period in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringRead-onlyRequired

Purchase order, if one has been supplied via our billing department

paymentTerminteger · integerRead-onlyRequired

The payment term in days (how many days are invoices generated before dateEnd)

pricePerMonthstringRead-onlyRequired

The price of this host per month in cents (see currencyId for currency)

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency of the pricePerMonth field:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

brandstringRead-onlyRequired

The server manufacturer brand name

modelstringRead-onlyRequired

The model of the server

isReserveinteger · integerRead-onlyRequired

If the host is reserved for a fleet isReserve set to 1

serviceTagstringRead-onlyRequired

The service tag of the host

isODPinteger · integerRead-onlyRequired

If the host is available for game hosting platform isODP set to 1

fmOrderIdstring · nullableRead-onlyRequired

ID of Flex Metal order if this is a flex metal server

installStatusstring · nullableRead-onlyRequired

Status of server auto install if it was started by one. (created / installing / finished / failed)

statusstringRead-onlyRequired

Whether the host is running or not

uptimeinteger · integerOptional

The uptime of the host. Read-only. Only provided if the server checked-in recently

trafficSuminteger · integerRead-onlyRequired

Monthly traffic of all incoming and outgoing bandwidth in GB or Mbit depending on host configuration

freeIncomingTrafficbooleanRead-onlyRequired

Whether the host has free incoming traffic or not

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

get
/v3/dedicatedServer/summary

Get a dedicated server (can be bare metal servers or VMs) and their main details

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
dedicatedServerIdintegerRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of this host

userIdinteger · integerRead-onlyRequired

The ID of the user who owns this server

serverIdinteger · integerRead-onlyRequired

The ID of the physical machine

serverNamestringRead-onlyRequired

The name of the physical machine

serverTypeinteger · integerRead-onlyRequired

The type of the server:

  • 1: Bare metal server
  • 2: Flex metal server
  • 3: Virtual machine
projectNamestringOptional

The name of the project for the host

clientServerNamestringOptional

The name of the server defined by client

clientStatestringOptional

Client statement for the host

liveHostNamestringRead-onlyRequired

The host name

isVirtualinteger · integerRead-onlyRequiredDeprecated

0 if this is a bare metal server, 1 if it's a VM. Use serverType instead

categorystringRead-onlyRequired

Host category. Normally "Dedicated Game Servers" or "Dedicated Servers", but can be "Broken" if the server is in a degraded state

osIdinteger · integerRead-onlyRequired

Operating system ID, must be one of GET /v3/operatingsystem

locationIdinteger · integerRead-onlyRequired

Legacy location ID (not used for ODP)

dcLocationIdinteger · integerRead-onlyRequired

Datacenter location ID. Points to one of GET /v3/cloud/dcLocation

instanceTypestringRead-onlyRequired

The instance type of this server, which is one of GET /v3/host/instanceType for a bare metal, or one of GET /v3/cloud/instanceType for a virtual machine

fleetIdstringRead-onlyRequired

The fleet ID, if this host has been assigned to a fleet If 0, the host has not been assigned to a fleet, otherwise, the fleet is assigned to this host and the host can serve application instances for that fleet.

newFleetIdstring · nullableRead-onlyRequired

The ID of a new fleet that is to be assigned to this host after performing a bulkReserve operation at POST /v3/fleet/host/bulkReserve

fleetAssociatedSinceinteger · integerRead-onlyRequired

Unix timestamp when fleet assigned to the host

rackNamestringRead-onlyRequired

The name of the rack the host is located

dateStartstringRead-onlyRequired

The date at which this host became active

dateEndstringRead-onlyRequired

The date at which this host will expire

dateCancelledstringRead-onlyRequired

The date at which this host was cancelled

dateEndContractstringRead-onlyRequired

The date at which the contract ends (if applicable)

contractPeriodinteger · integerRead-onlyRequired

The contract period in months

extendPeriodinteger · integerRead-onlyRequired

The service extend period in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringRead-onlyRequired

Purchase order, if one has been supplied via our billing department

paymentTerminteger · integerRead-onlyRequired

The payment term in days (how many days are invoices generated before dateEnd)

pricePerMonthstringRead-onlyRequired

The price of this host per month in cents (see currencyId for currency)

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency of the pricePerMonth field:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

brandstringRead-onlyRequired

The server manufacturer brand name

modelstringRead-onlyRequired

The model of the server

numCpuinteger · integerRead-onlyRequired

Number of CPUs in this host

cpuInfostringRead-onlyRequired
cpuTypestringRead-onlyRequired
cpuLoadnumber · floatRead-onlyRequired

Percentage of cpu used across all cores

memUsedinteger · integerRead-onlyRequired

The amount of memory that is used by the host (in megabytes)

memMaxinteger · integerRead-onlyRequired

The amount of memory that is available on the host (in megabytes)

memFreeinteger · integerRead-onlyRequired

The amount of free memory that is available on the host (in megabytes)

isReserveinteger · integerRead-onlyRequired

If the host is reserved for a fleet isReserve set to 1

serviceTagstringRead-onlyRequired

The service tag of the host

isODPinteger · integerRead-onlyRequired

If the host is available for game hosting platform isODP set to 1

fmOrderIdstring · nullableRead-onlyRequired

ID of Flex Metal order if this is a flex metal server

installStatusstring · nullableRead-onlyRequired

Status of server auto install if it was started by one. (created / installing / finished / failed)

statusstringRead-onlyRequired

Whether the host is running or not

uptimeinteger · integerOptional

The uptime of the host. Read-only. Only provided if the server checked-in recently

trafficSuminteger · integerRead-onlyRequired

Monthly traffic of all incoming and outgoing bandwidth in GB or Mbit depending on host configuration

freeIncomingTrafficbooleanRead-onlyRequired

Whether the host has free incoming traffic or not

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

get
/v3/dedicatedServer/{dedicatedServerId}

Can add, edit or delete dedicated server labels. To delete label need to provide key with null value.

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
dedicatedServerIdintegerRequired
Body
idinteger · integerRead-onlyRequired

The ID of this host

userIdinteger · integerRead-onlyRequired

The ID of the user who owns this server

serverIdinteger · integerRead-onlyRequired

The ID of the physical machine

serverNamestringRead-onlyRequired

The name of the physical machine

serverTypeinteger · integerRead-onlyRequired

The type of the server:

  • 1: Bare metal server
  • 2: Flex metal server
  • 3: Virtual machine
projectNamestringOptional

The name of the project for the host

clientServerNamestringOptional

The name of the server defined by client

clientStatestringOptional

Client statement for the host

liveHostNamestringRead-onlyRequired

The host name

isVirtualinteger · integerRead-onlyRequiredDeprecated

0 if this is a bare metal server, 1 if it's a VM. Use serverType instead

categorystringRead-onlyRequired

Host category. Normally "Dedicated Game Servers" or "Dedicated Servers", but can be "Broken" if the server is in a degraded state

osIdinteger · integerRead-onlyRequired

Operating system ID, must be one of GET /v3/operatingsystem

locationIdinteger · integerRead-onlyRequired

Legacy location ID (not used for ODP)

dcLocationIdinteger · integerRead-onlyRequired

Datacenter location ID. Points to one of GET /v3/cloud/dcLocation

instanceTypestringRead-onlyRequired

The instance type of this server, which is one of GET /v3/host/instanceType for a bare metal, or one of GET /v3/cloud/instanceType for a virtual machine

fleetIdstringRead-onlyRequired

The fleet ID, if this host has been assigned to a fleet If 0, the host has not been assigned to a fleet, otherwise, the fleet is assigned to this host and the host can serve application instances for that fleet.

newFleetIdstring · nullableRead-onlyRequired

The ID of a new fleet that is to be assigned to this host after performing a bulkReserve operation at POST /v3/fleet/host/bulkReserve

fleetAssociatedSinceinteger · integerRead-onlyRequired

Unix timestamp when fleet assigned to the host

rackNamestringRead-onlyRequired

The name of the rack the host is located

dateStartstringRead-onlyRequired

The date at which this host became active

dateEndstringRead-onlyRequired

The date at which this host will expire

dateCancelledstringRead-onlyRequired

The date at which this host was cancelled

dateEndContractstringRead-onlyRequired

The date at which the contract ends (if applicable)

contractPeriodinteger · integerRead-onlyRequired

The contract period in months

extendPeriodinteger · integerRead-onlyRequired

The service extend period in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringRead-onlyRequired

Purchase order, if one has been supplied via our billing department

paymentTerminteger · integerRead-onlyRequired

The payment term in days (how many days are invoices generated before dateEnd)

pricePerMonthstringRead-onlyRequired

The price of this host per month in cents (see currencyId for currency)

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency of the pricePerMonth field:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

brandstringRead-onlyRequired

The server manufacturer brand name

modelstringRead-onlyRequired

The model of the server

numCpuinteger · integerRead-onlyRequired

Number of CPUs in this host

cpuInfostringRead-onlyRequired
cpuTypestringRead-onlyRequired
cpuLoadnumber · floatRead-onlyRequired

Percentage of cpu used across all cores

memUsedinteger · integerRead-onlyRequired

The amount of memory that is used by the host (in megabytes)

memMaxinteger · integerRead-onlyRequired

The amount of memory that is available on the host (in megabytes)

memFreeinteger · integerRead-onlyRequired

The amount of free memory that is available on the host (in megabytes)

isReserveinteger · integerRead-onlyRequired

If the host is reserved for a fleet isReserve set to 1

serviceTagstringRead-onlyRequired

The service tag of the host

isODPinteger · integerRead-onlyRequired

If the host is available for game hosting platform isODP set to 1

fmOrderIdstring · nullableRead-onlyRequired

ID of Flex Metal order if this is a flex metal server

installStatusstring · nullableRead-onlyRequired

Status of server auto install if it was started by one. (created / installing / finished / failed)

statusstringRead-onlyRequired

Whether the host is running or not

uptimeinteger · integerOptional

The uptime of the host. Read-only. Only provided if the server checked-in recently

trafficSuminteger · integerRead-onlyRequired

Monthly traffic of all incoming and outgoing bandwidth in GB or Mbit depending on host configuration

freeIncomingTrafficbooleanRead-onlyRequired

Whether the host has free incoming traffic or not

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of this host

userIdinteger · integerRead-onlyRequired

The ID of the user who owns this server

serverIdinteger · integerRead-onlyRequired

The ID of the physical machine

serverNamestringRead-onlyRequired

The name of the physical machine

serverTypeinteger · integerRead-onlyRequired

The type of the server:

  • 1: Bare metal server
  • 2: Flex metal server
  • 3: Virtual machine
projectNamestringOptional

The name of the project for the host

clientServerNamestringOptional

The name of the server defined by client

clientStatestringOptional

Client statement for the host

liveHostNamestringRead-onlyRequired

The host name

isVirtualinteger · integerRead-onlyRequiredDeprecated

0 if this is a bare metal server, 1 if it's a VM. Use serverType instead

categorystringRead-onlyRequired

Host category. Normally "Dedicated Game Servers" or "Dedicated Servers", but can be "Broken" if the server is in a degraded state

osIdinteger · integerRead-onlyRequired

Operating system ID, must be one of GET /v3/operatingsystem

locationIdinteger · integerRead-onlyRequired

Legacy location ID (not used for ODP)

dcLocationIdinteger · integerRead-onlyRequired

Datacenter location ID. Points to one of GET /v3/cloud/dcLocation

instanceTypestringRead-onlyRequired

The instance type of this server, which is one of GET /v3/host/instanceType for a bare metal, or one of GET /v3/cloud/instanceType for a virtual machine

fleetIdstringRead-onlyRequired

The fleet ID, if this host has been assigned to a fleet If 0, the host has not been assigned to a fleet, otherwise, the fleet is assigned to this host and the host can serve application instances for that fleet.

newFleetIdstring · nullableRead-onlyRequired

The ID of a new fleet that is to be assigned to this host after performing a bulkReserve operation at POST /v3/fleet/host/bulkReserve

fleetAssociatedSinceinteger · integerRead-onlyRequired

Unix timestamp when fleet assigned to the host

rackNamestringRead-onlyRequired

The name of the rack the host is located

dateStartstringRead-onlyRequired

The date at which this host became active

dateEndstringRead-onlyRequired

The date at which this host will expire

dateCancelledstringRead-onlyRequired

The date at which this host was cancelled

dateEndContractstringRead-onlyRequired

The date at which the contract ends (if applicable)

contractPeriodinteger · integerRead-onlyRequired

The contract period in months

extendPeriodinteger · integerRead-onlyRequired

The service extend period in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringRead-onlyRequired

Purchase order, if one has been supplied via our billing department

paymentTerminteger · integerRead-onlyRequired

The payment term in days (how many days are invoices generated before dateEnd)

pricePerMonthstringRead-onlyRequired

The price of this host per month in cents (see currencyId for currency)

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency of the pricePerMonth field:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

brandstringRead-onlyRequired

The server manufacturer brand name

modelstringRead-onlyRequired

The model of the server

numCpuinteger · integerRead-onlyRequired

Number of CPUs in this host

cpuInfostringRead-onlyRequired
cpuTypestringRead-onlyRequired
cpuLoadnumber · floatRead-onlyRequired

Percentage of cpu used across all cores

memUsedinteger · integerRead-onlyRequired

The amount of memory that is used by the host (in megabytes)

memMaxinteger · integerRead-onlyRequired

The amount of memory that is available on the host (in megabytes)

memFreeinteger · integerRead-onlyRequired

The amount of free memory that is available on the host (in megabytes)

isReserveinteger · integerRead-onlyRequired

If the host is reserved for a fleet isReserve set to 1

serviceTagstringRead-onlyRequired

The service tag of the host

isODPinteger · integerRead-onlyRequired

If the host is available for game hosting platform isODP set to 1

fmOrderIdstring · nullableRead-onlyRequired

ID of Flex Metal order if this is a flex metal server

installStatusstring · nullableRead-onlyRequired

Status of server auto install if it was started by one. (created / installing / finished / failed)

statusstringRead-onlyRequired

Whether the host is running or not

uptimeinteger · integerOptional

The uptime of the host. Read-only. Only provided if the server checked-in recently

trafficSuminteger · integerRead-onlyRequired

Monthly traffic of all incoming and outgoing bandwidth in GB or Mbit depending on host configuration

freeIncomingTrafficbooleanRead-onlyRequired

Whether the host has free incoming traffic or not

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

put
/v3/dedicatedServer/{dedicatedServerId}

Get list of all colocated servers

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringRequired

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of the colocation service

namestringOptional

The name of the colocation service

dateStartstringRead-onlyRequired

Contract start date

dateEndstringRead-onlyRequired

The date until which the service is paid

dateCancelledstringRead-onlyRequired

Contract cancel date if contract is cancelled

dateEndContractstringRead-onlyRequired

Contract end date

contractPeriodinteger · integerRead-onlyRequired

The duration of the contract in months

extendPeriodinteger · integerRead-onlyRequired

The extended period of the contract in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringOptional

The order-name to which the server belongs

paymentTerminteger · integerRead-onlyRequired

The duration in which the invoice has to be paid after receiving.

pricePerMonthstringRead-onlyRequired

The price of this colocated server per month in cents

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency in which the various 'price' fields are:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

trafficSuminteger · integerRead-onlyRequired

The total used traffic (Mbit or GB, incoming + outgoing)

trafficSumMonthMbitinteger · integerRead-onlyRequired

The total used traffic (Mbit) for 95th percentile

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

powerMaxAmperestringRead-onlyRequired

Contractual maximum usable amperage

powerKwhPricestringRead-onlyRequired

The power price per kWh in cents

powerMeterinteger · integerRead-onlyRequired

The current power meter(kWh)

unlimitedIngressinteger · integerRead-onlyRequired

Does the service have free incoming traffic?

get
/v3/colocation

Get the colocated server by ID

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of the colocation service

namestringOptional

The name of the colocation service

dateStartstringRead-onlyRequired

Contract start date

dateEndstringRead-onlyRequired

The date until which the service is paid

dateCancelledstringRead-onlyRequired

Contract cancel date if contract is cancelled

dateEndContractstringRead-onlyRequired

Contract end date

contractPeriodinteger · integerRead-onlyRequired

The duration of the contract in months

extendPeriodinteger · integerRead-onlyRequired

The extended period of the contract in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringOptional

The order-name to which the server belongs

paymentTerminteger · integerRead-onlyRequired

The duration in which the invoice has to be paid after receiving.

pricePerMonthstringRead-onlyRequired

The price of this colocated server per month in cents

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency in which the various 'price' fields are:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

trafficSuminteger · integerRead-onlyRequired

The total used traffic (Mbit or GB, incoming + outgoing)

trafficSumMonthMbitinteger · integerRead-onlyRequired

The total used traffic (Mbit) for 95th percentile

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

powerMaxAmperestringRead-onlyRequired

Contractual maximum usable amperage

powerKwhPricestringRead-onlyRequired

The power price per kWh in cents

powerMeterinteger · integerRead-onlyRequired

The current power meter(kWh)

unlimitedIngressinteger · integerRead-onlyRequired

Does the service have free incoming traffic?

get
/v3/colocation/{colocationId}

Update the colocated server by ID

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired
Body
idinteger · integerRead-onlyRequired

The ID of the colocation service

namestringOptional

The name of the colocation service

dateStartstringRead-onlyRequired

Contract start date

dateEndstringRead-onlyRequired

The date until which the service is paid

dateCancelledstringRead-onlyRequired

Contract cancel date if contract is cancelled

dateEndContractstringRead-onlyRequired

Contract end date

contractPeriodinteger · integerRead-onlyRequired

The duration of the contract in months

extendPeriodinteger · integerRead-onlyRequired

The extended period of the contract in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringOptional

The order-name to which the server belongs

paymentTerminteger · integerRead-onlyRequired

The duration in which the invoice has to be paid after receiving.

pricePerMonthstringRead-onlyRequired

The price of this colocated server per month in cents

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency in which the various 'price' fields are:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

trafficSuminteger · integerRead-onlyRequired

The total used traffic (Mbit or GB, incoming + outgoing)

trafficSumMonthMbitinteger · integerRead-onlyRequired

The total used traffic (Mbit) for 95th percentile

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

powerMaxAmperestringRead-onlyRequired

Contractual maximum usable amperage

powerKwhPricestringRead-onlyRequired

The power price per kWh in cents

powerMeterinteger · integerRead-onlyRequired

The current power meter(kWh)

unlimitedIngressinteger · integerRead-onlyRequired

Does the service have free incoming traffic?

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of the colocation service

namestringOptional

The name of the colocation service

dateStartstringRead-onlyRequired

Contract start date

dateEndstringRead-onlyRequired

The date until which the service is paid

dateCancelledstringRead-onlyRequired

Contract cancel date if contract is cancelled

dateEndContractstringRead-onlyRequired

Contract end date

contractPeriodinteger · integerRead-onlyRequired

The duration of the contract in months

extendPeriodinteger · integerRead-onlyRequired

The extended period of the contract in months

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

purchaseOrderstringOptional

The order-name to which the server belongs

paymentTerminteger · integerRead-onlyRequired

The duration in which the invoice has to be paid after receiving.

pricePerMonthstringRead-onlyRequired

The price of this colocated server per month in cents

pricePerTbOverusestringRead-onlyRequired

The price of traffic overuse in cents (per TB) (see currencyId for currency)

currencyIdinteger · integerRead-onlyRequired

The currency in which the various 'price' fields are:

  • 0: EURO
  • 1: USD
  • 9: YEN
bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
bandwidthContractualinteger · integerRead-onlyRequired

The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise

trafficSuminteger · integerRead-onlyRequired

The total used traffic (Mbit or GB, incoming + outgoing)

trafficSumMonthMbitinteger · integerRead-onlyRequired

The total used traffic (Mbit) for 95th percentile

outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB)

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB)

powerMaxAmperestringRead-onlyRequired

Contractual maximum usable amperage

powerKwhPricestringRead-onlyRequired

The power price per kWh in cents

powerMeterinteger · integerRead-onlyRequired

The current power meter(kWh)

unlimitedIngressinteger · integerRead-onlyRequired

Does the service have free incoming traffic?

put
/v3/colocation/{colocationId}

Get all the invoices for a specific colocated service

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated service to fetch invoices for

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The ID of the invoice

creationDateinteger · integerRead-onlyRequired

The date the invoice was created

dueDateinteger · integerRead-onlyRequired

The due date of the invoice

invoiceNumberstringRead-onlyRequired

The number of the invoice

invoiceHashstringRead-onlyRequired

A unique hash for this invoice

descriptionstringRequired

The description of the invoice

currencystringRequired

The currency that is being used

currencySignstringRequired

The currency sign that is being used

amountIncVATstringRequired

The amount of the invoice with VAT in cents

amountExclVATstringRequired

The amount of the invoice without VAT in cents

paymentStatusinteger · integerRequired

The payment status

paymentDateinteger · integerRequired

The timestamp that the invoice was paid, if paid

isCreditinteger · integerRequired

If this field is 1 it means that invoice is a credit invoice

remainingAmountstringRequired

The remaining amount of invoice

totalPaidAmountstringRequired

The total paid amount of invoice

get
/v3/colocation/{colocationId}/invoice

Get all the PDUs for a specific colocated service

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated service to fetch PDUs for

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The id of feed

namestringRequired

The feed name

serialstringRequired

The serial number

updatedAtinteger · integerRequired

The last update time

inputFeedTypestringRequired

The feed type

outletsinteger · integerRequired

The number of outlets on this pdu

phasesinteger · integerRequired

The number of phases that this pdu supports

powerMeterinteger · integerRequired

The last registered counter value

powerFactornumber · floatRequired

The total power factor

amperagenumber · floatRequired

The total amperage supported by pdu

peakAmperagenumber · floatRequired

The peak amperage

voltagenumber · floatRequired

The total actual voltage

minVoltagenumber · floatRequired

The total min voltage

get
/v3/colocation/{colocationId}/pdu

Get the traffic usage data for the last day

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Query parameters
startTimeintegerOptional

Start unix timestamp

endTimeintegerOptional

End unix timestamp

Responses
chevron-right
200

OK

application/json
unitstringRead-onlyRequired

Unit of data frequency, possible interval options are as follows

  • day
get
/v3/colocation/{colocationId}/network/usage/{upLinkId}/raw

Get the traffic usage graph (last year)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/colocation/{colocationId}/network/usage/{upLinkId}/graph/year

Get the traffic usage graph (last 30 days)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/colocation/{colocationId}/network/usage/{upLinkId}/graph/month

Get the traffic usage graph (last 7 days)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/colocation/{colocationId}/network/usage/{upLinkId}/graph/week

Get the traffic usage graph (last 24 hours)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/colocation/{colocationId}/network/usage/{upLinkId}/graph/day

Get all the alerts linked to the colocated server

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server to get the alerts for

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Colocation alert ID

percentageinteger · integerRequired

At what percentage of bandwidth usage to trigger the alert

sendMailinteger · integerRequired

Will send an email notification when alert is triggered

sendTicketinteger · integerRequired

WIll create a ticket notification when alert is triggered

triggeredinteger · integerRead-onlyRequired

UNIX timestamp of the last time the alert was triggered

createdAtinteger · integerRead-onlyRequired

UNIX timestamp of the time the alert was created

get
/v3/colocation/{colocationId}/alert

Create alert for the colocated server

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server to create an alert for

Body
idinteger · integerRead-onlyRequired

Colocation alert ID

percentageinteger · integerRequired

At what percentage of bandwidth usage to trigger the alert

sendMailinteger · integerRequired

Will send an email notification when alert is triggered

sendTicketinteger · integerRequired

WIll create a ticket notification when alert is triggered

triggeredinteger · integerRead-onlyRequired

UNIX timestamp of the last time the alert was triggered

createdAtinteger · integerRead-onlyRequired

UNIX timestamp of the time the alert was created

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Colocation alert ID

percentageinteger · integerRequired

At what percentage of bandwidth usage to trigger the alert

sendMailinteger · integerRequired

Will send an email notification when alert is triggered

sendTicketinteger · integerRequired

WIll create a ticket notification when alert is triggered

triggeredinteger · integerRead-onlyRequired

UNIX timestamp of the last time the alert was triggered

createdAtinteger · integerRead-onlyRequired

UNIX timestamp of the time the alert was created

post
/v3/colocation/{colocationId}/alert

Update colocated server alert

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server that the alert belongs to

colocationAlertIdintegerRequired

ID of the host alert to update

Body
idinteger · integerRead-onlyRequired

Colocation alert ID

percentageinteger · integerRequired

At what percentage of bandwidth usage to trigger the alert

sendMailinteger · integerRequired

Will send an email notification when alert is triggered

sendTicketinteger · integerRequired

WIll create a ticket notification when alert is triggered

triggeredinteger · integerRead-onlyRequired

UNIX timestamp of the last time the alert was triggered

createdAtinteger · integerRead-onlyRequired

UNIX timestamp of the time the alert was created

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Colocation alert ID

percentageinteger · integerRequired

At what percentage of bandwidth usage to trigger the alert

sendMailinteger · integerRequired

Will send an email notification when alert is triggered

sendTicketinteger · integerRequired

WIll create a ticket notification when alert is triggered

triggeredinteger · integerRead-onlyRequired

UNIX timestamp of the last time the alert was triggered

createdAtinteger · integerRead-onlyRequired

UNIX timestamp of the time the alert was created

put
/v3/colocation/{colocationId}/alert/{colocationAlertId}

Delete colocated server alert

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server that the alert belongs to

colocationAlertIdintegerRequired

ID of the alert to delete

Responses
delete
/v3/colocation/{colocationId}/alert/{colocationAlertId}

No content

Cancel the colocated server

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocated server that the cancellation should applied to

Responses
put
/v3/colocation/{colocationId}/cancel

No content

Revert the cancellation of a colocated server

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the cancelled colocated server that should be reverted

Responses
put
/v3/colocation/{colocationId}/cancel/revert

No content

Get the list of all cross connect

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
get
/v3/crossConnect

Get the list of all cross connect

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired

The ID of the cross connect

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
get
/v3/crossConnect/{crossConnectId}

Update the cross connect by ID

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired
Body
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
put
/v3/crossConnect/{crossConnectId}

Get all the invoices for a specific cross connect

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired

The ID of the cross connect

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
get
/v3/crossConnect/{crossConnectId}/invoice

cancel the cross connect by ID

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired
Body
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
Responses
put
/v3/crossConnect/{crossConnectId}/cancel

No content

Revert the cancellation of a cross connect by ID

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired
Body
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Cross connect ID

dateStartstringRead-onlyRequired

Start date of the cross connect

dateEndstringRead-onlyRequired

End date of the cross connect

dateCancelledstringRead-onlyRequired

Cancelled date of the cross connect

dateEndContractstringRead-onlyRequired

End contract date of the cross connect

contractPeriodinteger · integerRead-onlyRequired

Contract period of the cross connect

extendPeriodinteger · integerRead-onlyRequired

Extend period of the cross connect

cancellationPeriodinteger · integerRead-onlyRequired

The cancellation period in months

paymentTerminteger · integerRead-onlyRequired

Payment term of the cross connect

purchaseOrderstringOptional

Purchase order of the cross connect

monthlyFeestringRead-onlyRequired

Monthly fee of the cross connect in cents

setupFeestringRead-onlyRequired

Setup fee of the cross connect in cents

currencyIdinteger · integerRead-onlyRequired

The currency ID

  • 0: EURO
  • 1: USD
  • 9: YEN
colocatedServerIdinteger · integerRead-onlyRequired

Colocated server ID

hostIdinteger · integerRead-onlyRequired

Host ID

locationIdSideAinteger · integerRead-onlyRequired

Location ID of the Side A

locationIdSideANamestringRead-onlyRequired

Location name of the Side A

locationIdSideZinteger · integerRead-onlyRequired

Location ID of the Side B

locationIdSideZNamestringRead-onlyRequired

Location name of the Side B

locationDetailsstringRead-onlyRequired

Location details

rackIdSideAinteger · integerRead-onlyRequired

Rack ID of the Side A

rackIdSideANamestringRead-onlyRequired

Rack Name of the Side A

rackIdSideZinteger · integerRead-onlyRequired

Rack ID of the Side B

rackIdSideZNamestringRead-onlyRequired

Rack Name of the Side B

goLiveDatestringRead-onlyRequired

Go live date

internalIdstringRead-onlyRequired

Internal ID of the service

patchInternalNamestringRead-onlyRequired

Internal name of the patch

patchCustomerNamestringOptional

Customer name of the patch

thirdPartyIdstringRead-onlyRequired

Third party ID of the service

vendorIdinteger · integerRead-onlyRequired

Vendor ID of the service

cableTypeinteger · integerRead-onlyRequired

Type of cable

cableSpeedinteger · integerRead-onlyRequired

Cable speed

connectorSideATypeinteger · integerRead-onlyRequired

Connector of Side A

connectorSideZTypeinteger · integerRead-onlyRequired

Connector of Side Z

diverseFromPatchIdinteger · integerRead-onlyRequired

Diverse from patch id

customerNotesstringRead-onlyRequired

Notes of the customer

connectivityTypestringRead-onlyRequired

The type of connectivity service Following will be possible values:

  • Connectivity: Transport
  • Connectivity: IP connectivity
  • Connectivity: Crossconnect
outgoingTrafficSuminteger · integerRead-onlyRequired

The outgoing traffic (Mbit or GB - defined by "bandwidthBillingType")

incomingTrafficSuminteger · integerRead-onlyRequired

The incoming traffic (Mbit or GB - defined by "bandwidthBillingType")

bandwidthBillingTypeinteger · integerRead-onlyRequired

The bandwidth billing method for this service:

  • 1: unmetered connection
  • 2: measured in TB per month
  • 3: measured in mbit 95th percentile
put
/v3/crossConnect/{crossConnectId}/cancel/revert

Get the traffic usage graph (last year)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired

ID of the cross connect to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/crossConnect/{crossConnectId}/network/usage/{upLinkId}/graph/year

Get the traffic usage graph (last 30 days)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired

ID of the cross connect to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/crossConnect/{crossConnectId}/network/usage/{upLinkId}/graph/month

Get the traffic usage graph (last 7 days)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired

ID of the cross connect to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/crossConnect/{crossConnectId}/network/usage/{upLinkId}/graph/week

Get the traffic usage graph (last 24 hours)

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
crossConnectIdintegerRequired

ID of the cross connect to fetch traffic for

upLinkIdintegerRequired

ID of the uplink to fetch traffic for

Responses
chevron-right
200

Base64 encoded image string

application/json
string[]Optional
get
/v3/crossConnect/{crossConnectId}/network/usage/{upLinkId}/graph/day

Set RDNS hostname for IP

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
colocationIdintegerRequired

ID of the colocation-service to which IP address belongs to

ipAddressstringRequired

IP address to set RDNS entry for

Body
hostnamestringRequired

The hostname

ipstringRead-onlyRequired

The corresponding ip for the host

Responses
put
/v3/colocation/{colocationId}/network/rdns/{ipAddress}

No content

Switch server port rate limit

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
serverIdintegerRequired

ID of the server

Body
serverIdinteger · integerRequired

Server ID

networkInterfaceIdinteger · integerRequired

Network Interface ID or graphUrl

rateLimitinteger · integerRequired

Port rate limit

Responses
put
/v3/server/{serverId}/pxe/switchportratelimit

No content

Switch server port speed

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
serverIdintegerRequired

ID of the server

Body
serverIdinteger · integerRequired

Server ID

networkInterfaceIdinteger · integerRequired

Network Interface ID or graphUrl

portSpeedinteger · integerRequired

Port Speed

Responses
put
/v3/server/{serverId}/pxe/switchportspeed

No content

Switch server port admin state

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
serverIdintegerRequired

ID of the server

Body
serverIdinteger · integerRequired

Server ID

networkInterfaceIdinteger · integerRequired

Network Interface ID or graphUrl

stateinteger · integerRequired

Port admin state

Responses
put
/v3/server/{serverId}/pxe/switchportadminstate

No content

Get all the available operating systems

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of this operating system

namestringRead-onlyRequired

The name of this operating system

slugstringRead-onlyRequired

Unique key for operating system

osGroupinteger · integerRead-onlyRequired

The operating system group.

  1. Windows
  2. Linux / BSD
isOdpinteger · integerRead-onlyRequired

1 if you can use this operating system with ODP, 0 otherwise.

availableForFlexMetalinteger · integerRead-onlyRequired

1 if you can use this operating system with Flex Metal, 0 otherwise.

activeinteger · integerRead-onlyRequired

1 if this operating system is an active operating system, 0 otherwise.

get
/v3/operatingsystem

Get the list of all your slack settings

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The ID of the slack setting

namestringRequired

The slack setting name

webHookUrlstringRequired
channelstringRequired

The slack setting channel name

userNamestringRequired

The slack setting channel username

get
/v3/slackSetting

Create a slack setting

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idstringRead-onlyRequired

The ID of the slack setting

namestringRequired

The slack setting name

webHookUrlstringRequired
channelstringRequired

The slack setting channel name

userNamestringRequired

The slack setting channel username

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The ID of the slack setting

namestringRequired

The slack setting name

webHookUrlstringRequired
channelstringRequired

The slack setting channel name

userNamestringRequired

The slack setting channel username

post
/v3/slackSetting

Get a single slack setting

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
slackSettingIdstringRequired

The Id of the slack setting

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The ID of the slack setting

namestringRequired

The slack setting name

webHookUrlstringRequired
channelstringRequired

The slack setting channel name

userNamestringRequired

The slack setting channel username

get
/v3/slackSetting/{slackSettingId}

Update a slack setting

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
slackSettingIdstringRequired

The Id of the slack setting

Body
idstringRead-onlyRequired

The ID of the slack setting

namestringRequired

The slack setting name

webHookUrlstringRequired
channelstringRequired

The slack setting channel name

userNamestringRequired

The slack setting channel username

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The ID of the slack setting

namestringRequired

The slack setting name

webHookUrlstringRequired
channelstringRequired

The slack setting channel name

userNamestringRequired

The slack setting channel username

put
/v3/slackSetting/{slackSettingId}

Remove a slack setting

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
slackSettingIdstringRequired

The Id of the slack setting

Responses
delete
/v3/slackSetting/{slackSettingId}

No content

Get details of all invoices of a user

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
filterstringOptional

The filter to search for the description
The filter parameter can be used to apply a more specific search, the only element that can be filtered is 'description'.
The filter will be done on a part of the provided description (it should contain the searched element).
E.g. we need to filter for a string "this is an example"
Remember to urlencode the provided filter
The final call would look like:
/billing/invoice?filter=this%20is%20an%20example

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The ID of the invoice

creationDateinteger · integerRead-onlyRequired

The date the invoice was created

dueDateinteger · integerRead-onlyRequired

The due date of the invoice

invoiceNumberstringRead-onlyRequired

The number of the invoice

invoiceHashstringRead-onlyRequired

A unique hash for this invoice

descriptionstringRequired

The description of the invoice

currencystringRequired

The currency that is being used

currencySignstringRequired

The currency sign that is being used

amountIncVATstringRequired

The amount of the invoice with VAT in cents

amountExclVATstringRequired

The amount of the invoice without VAT in cents

paymentStatusinteger · integerRequired

The payment status

paymentDateinteger · integerRequired

The timestamp that the invoice was paid, if paid

isCreditinteger · integerRequired

If this field is 1 it means that invoice is a credit invoice

remainingAmountstringRequired

The remaining amount of invoice

totalPaidAmountstringRequired

The total paid amount of invoice

get
/v3/account/invoice

Get details of all unpaid invoices for a user (excluding credit invoices)

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
filterstringOptional

The filter to search for the description
The filter parameter can be used to apply a more specific search, the only element that can be filtered is 'description'.
The filter will be done on a part of the provided description (it should contain the searched element).
E.g. we need to filter for a string "this is an example"
Remember to urlencode the provided filter
The final call would look like:
/billing/invoice?filter=this%20is%20an%20example

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The ID of the invoice

creationDateinteger · integerRead-onlyRequired

The date the invoice was created

dueDateinteger · integerRead-onlyRequired

The due date of the invoice

invoiceNumberstringRead-onlyRequired

The number of the invoice

invoiceHashstringRead-onlyRequired

A unique hash for this invoice

descriptionstringRequired

The description of the invoice

currencystringRequired

The currency that is being used

currencySignstringRequired

The currency sign that is being used

amountIncVATstringRequired

The amount of the invoice with VAT in cents

amountExclVATstringRequired

The amount of the invoice without VAT in cents

paymentStatusinteger · integerRequired

The payment status

paymentDateinteger · integerRequired

The timestamp that the invoice was paid, if paid

isCreditinteger · integerRequired

If this field is 1 it means that invoice is a credit invoice

remainingAmountstringRequired

The remaining amount of invoice

totalPaidAmountstringRequired

The total paid amount of invoice

get
/v3/account/invoice/unpaid

Get invoice details by invoice ID

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
invoiceIdintegerRequired

ID of the invoice to fetch details about

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of the invoice

invoiceNumberstringRead-onlyRequired

Invoice number

invoiceHashstringRead-onlyRequired

A unique hash for this invoice

clientNumberstringRead-onlyRequired

Client number

creationDatestringRead-onlyRequired

The date the invoice was created

dueDatestringRead-onlyRequired

The due date of the invoice

paymentStatusinteger · integerRead-onlyRequired

Whether or not the invoice was paid

paymentDateinteger · integerRequired

The timestamp that the invoice was paid, if paid

isCreditinteger · integerRequired

If this field is 1 it means that invoice is a credit invoice

paymentTerminteger · integerRead-onlyRequired

The invoice must be paid in the given amount of time (days)

currencystringRead-onlyRequired

The name of the currency that is being used

currencySignstringRead-onlyRequired

The sign of the currency that is being used

vatPercentageinteger · integerRead-onlyRequired

Percentage of VAT applied

vatAmountstringRead-onlyRequired

Amount of VAT to pay in cents

amountIncVatstringRead-onlyRequired

The amount of the invoice with VAT included in cents

amountExclVatstringRead-onlyRequired

The amount of the invoice without VAT in cents

get
/v3/account/invoice/{invoiceId}

Get invoice details by invoice number

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
invoiceNumberstringRequired

Number of the invoice to fetch details about

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of the invoice

invoiceNumberstringRead-onlyRequired

Invoice number

invoiceHashstringRead-onlyRequired

A unique hash for this invoice

clientNumberstringRead-onlyRequired

Client number

creationDatestringRead-onlyRequired

The date the invoice was created

dueDatestringRead-onlyRequired

The due date of the invoice

paymentStatusinteger · integerRead-onlyRequired

Whether or not the invoice was paid

paymentDateinteger · integerRequired

The timestamp that the invoice was paid, if paid

isCreditinteger · integerRequired

If this field is 1 it means that invoice is a credit invoice

paymentTerminteger · integerRead-onlyRequired

The invoice must be paid in the given amount of time (days)

currencystringRead-onlyRequired

The name of the currency that is being used

currencySignstringRead-onlyRequired

The sign of the currency that is being used

vatPercentageinteger · integerRead-onlyRequired

Percentage of VAT applied

vatAmountstringRead-onlyRequired

Amount of VAT to pay in cents

amountIncVatstringRead-onlyRequired

The amount of the invoice with VAT included in cents

amountExclVatstringRead-onlyRequired

The amount of the invoice without VAT in cents

get
/v3/account/invoice/number/{invoiceNumber}

Get invoice as PDF

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
invoiceIdintegerRequired

ID of the invoice to fetch details about

Responses
chevron-right
200

OK

application/pdf
string · binaryOptional
get
/v3/account/invoice/{invoiceId}/pdf

Get prepared data for the front-end to begin the pay process of invoice(s)

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
invoiceIdsstringRequired

The invoiceId(s) to prepare pay data for separated by comma (,)
Remember to urlencode the provided invoiceIds
The invoiceIds call would look like:
/v3/account/invoice/pay/prepare?invoiceIds=111111%2C22222%2C33333%2C44444

Responses
chevron-right
200

OK

application/json
totalAmountstringRead-onlyRequired

The total amount of the selected invoices

currencystringRequired

The currency that is being used

currencySignstringRequired

The currency sign that is being used

totalSelectedInvoiceForPayinteger · integerRequired

The total selected invoices for pay

totalSelectedCreditForSettleinteger · integerRequired

The total selected credit invoices for settle

accountCreditstringRequired

The amount of the account credit

get
/v3/account/invoice/pay/prepare

post invoice(s) data to register the transaction with the selected payment provider

post
Authorizations
PRIVATE-TOKENstringRequired
Body
invoiceIdsstringRequired
paymentMethodIdinteger · integerRequired
issuerIdstringRequired
Responses
chevron-right
200

OK

application/json
requestUrlstringRequired

URL where to send the user with post form data

accountCreditstringRequired

The amount of the account credit

totalAmountstringRequired

Total amount to pay

post
/v3/account/invoice/pay/register

Get invoice plus extra information to show on landing page after payment

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
messagestringRead-onlyRequired

Payment processing result message

statusstringRead-onlyRequired

Payment processing result status

paymentMethodstringRead-onlyRequired

The method of the payment

get
/v3/account/invoice/pay/paymentLanding

Get all available ping site

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
continentIdinteger · integerRequired

The ID of the continent

continentNamestringRequired

The name of the continent

countryIdinteger · integerRequired

The ID of the country

countrystringRequired

The name of the country

dcLocationIdinteger · integerRequired

The ID of the data center. Find all possible values from GET /cloud/dcLocation

dcLocationNamestringRequired

The name of the data center. Find all possible values from GET /cloud/dcLocation

hostnamestringRead-onlyRequired

The host name of the ping server in this data center

ipv4string[]Read-onlyRequiredDeprecated

List of ip address of ip version 4

ipv6string[]Read-onlyRequiredDeprecated

List of ip address of ip version 6

get
/v3/pingsite

Get all available ping site its detail beacon information

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
continentIdinteger · integerRead-onlyRequired

The ID of the continent

continentNamestringRead-onlyRequired

The name of the continent

countryIdinteger · integerRead-onlyRequired

The ID of the country

countryNamestringRead-onlyRequired

The name of the country

dcLocationIdinteger · integerRead-onlyRequired

The ID of the data center. Find all possible values from GET /cloud/dcLocation

dcLocationNamestringRead-onlyRequired

The name of the data center. Find all possible values from GET /cloud/dcLocation

regionNamestringRead-onlyRequired

The region name of the ping server in this data center

get
/v3/pingsite/detail

Get all available ping site latency

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
authStatusbooleanRequired
authservicebooleanRequired
authuserbooleanRequired
responseTimenumber · floatRequired
statusstringRequired
serverTimestringRequired
get
/v3/pingsite/latency

Get all available callback endpoints

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Callback setting ID, can be used as callbackSettingId in other endpoints.

urlstringRequired

This is the url that the system will use when the callback is executed.

urlDescriptionstringOptional

Description of the callback setting.

headersstringOptional

For sending additional meta information about the callback request.

get
/v3/callback

Create a callback

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idinteger · integerRead-onlyRequired

Callback setting ID, can be used as callbackSettingId in other endpoints.

urlstringRequired

This is the url that the system will use when the callback is executed.

urlDescriptionstringOptional

Description of the callback setting.

headersstringOptional

For sending additional meta information about the callback request.

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Callback setting ID, can be used as callbackSettingId in other endpoints.

urlstringRequired

This is the url that the system will use when the callback is executed.

urlDescriptionstringOptional

Description of the callback setting.

headersstringOptional

For sending additional meta information about the callback request.

post
/v3/callback

Get a callback for a given callbackSettingId

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
callbackSettingIdintegerRequired

The Id of the callback setting

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Callback setting ID, can be used as callbackSettingId in other endpoints.

urlstringRequired

This is the url that the system will use when the callback is executed.

urlDescriptionstringOptional

Description of the callback setting.

headersstringOptional

For sending additional meta information about the callback request.

get
/v3/callback/{callbackSettingId}

Update given callback

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
callbackSettingIdintegerRequired

The Id of the callback setting

Body
idinteger · integerRead-onlyRequired

Callback setting ID, can be used as callbackSettingId in other endpoints.

urlstringRequired

This is the url that the system will use when the callback is executed.

urlDescriptionstringOptional

Description of the callback setting.

headersstringOptional

For sending additional meta information about the callback request.

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Callback setting ID, can be used as callbackSettingId in other endpoints.

urlstringRequired

This is the url that the system will use when the callback is executed.

urlDescriptionstringOptional

Description of the callback setting.

headersstringOptional

For sending additional meta information about the callback request.

put
/v3/callback/{callbackSettingId}

Delete given callback

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
callbackSettingIdintegerRequired

The Id of the callback setting

Responses
delete
/v3/callback/{callbackSettingId}

No content

Get logs of all API v3 request

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringRequired

Example header: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
get
/v3/account/apiLog

Get logs of all API v3 request for the given requestType

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
requestTypestringRequired

The Http method that was used in the call. Possible values are {GET, POST, PUT and DELETE}

Header parameters
RANGED-DATAstringRequired

Example header: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
get
/v3/account/apiLog/{requestType}

Get list of all countries

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The country ID

codestringRead-onlyRequired

The country code

namestringRead-onlyRequired

The country name

continentstringRead-onlyRequired

The continent name

get
/v3/country

Sign up a new account

post
Authorizations
PRIVATE-TOKENstringRequired
Body
emailAddressstringRequired

New Account Email Address

passwordstringRequired

New Account Password

firstNamestringRequired

First name.

lastNamestringRequired

Last name.

newsletterinteger · integerRequired

Whether or not newsletter is subscribed to

agreeTocinteger · integerRequired

Whether or not Terms and Conditions are agreed to. Cannot be changed after agreeing.

agreeAupinteger · integerRequired

Whether or not Acceptable Use Policy is agreed to. Cannot be changed after agreeing.

agreeDpainteger · integerRequired

Whether or not Data Processing Agreement is agreed to. Cannot be changed after agreeing.

Responses
chevron-right
200

OK

application/json
idinteger · integerRequired

User ID

usernamestringRequired

User Name

emailstringRequired

Email

firstNamestringRequired

First name.

lastNamestringRequired

Last name.

newsletterinteger · integerRequired

Whether or not newsletter is subscribed to

agreeTocinteger · integerRequired

Whether or not Terms and Conditions are agreed to. Cannot be changed after agreeing.

agreeAupinteger · integerRequired

Whether or not Acceptable Use Policy is agreed to. Cannot be changed after agreeing.

agreeDpainteger · integerRequired

Whether or not Data Processing Agreement is agreed to. Cannot be changed after agreeing.

post
/v3/account/signUp

Change the password

put
Authorizations
PRIVATE-TOKENstringRequired
Body
currentPasswordstringRequired

Current Password

newPasswordstringRequired

New Password

Responses
put
/v3/account/password

No content

Reset the password

post
Authorizations
PRIVATE-TOKENstringRequired
Body
emailAddressstringRequired

Main Email Address

Responses
post
/v3/account/password/reset

No content

Validate the reset password

put
Authorizations
PRIVATE-TOKENstringRequired
Body
newPasswordstringRequired

New Password

resetHashstringRequired

Reset Hash

Responses
put
/v3/account/password/reset/validate

No content

Confirm email

put
Authorizations
PRIVATE-TOKENstringRequired
Body
userIdinteger · integerRequired

UserId

hashstringRequired

Hash

Responses
chevron-right
200

OK

application/json
emailAddressstringRequired

The e-mail address that was validated

Example: [email protected]
emailTypestringRequired

Type of e-mail that was validated, possible types can be main, billing or abuse

Example: billing
put
/v3/account/email/confirm

Resend email confirmation

post
Authorizations
PRIVATE-TOKENstringRequired
Body
emailstringRequired

Email to resend the confirmation for

Responses
post
/v3/account/email/confirm/resend

No content

Resend email confirmation

post
Authorizations
PRIVATE-TOKENstringRequired
Body
emailstringRequired

Email to resend the confirmation for

Responses
post
/v3/account/email/confirm/resend/oauth

No content

Get account details

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
accountTypeinteger · integerRequired

Account type: 1 - consumer, 2 - business. Can only be updated by submitting a support ticket.

companyNamestring · nullableOptional

Company name (for business accounts). Can only be updated by submitting a support ticket.

vatNumberstring · nullableOptional

VAT number (for business accounts). Can only be updated by submitting a support ticket.

cocNumberstring · nullableOptional

CoC number (only for Netherlands accounts). Can only be updated by submitting a support ticket.

firstNamestringRequired

First name.

lastNamestringRequired

Last name.

addressstringRequired

Address - street name.

streetNumberstringRequired

House number

zipCodestringRequired

ZIP / Post code.

citystringRequired

City.

countryCodestringRequired

Country code in ISO 3166-1 alpha-2 format.

emailAddressstringRead-onlyRequired

Email address

emailAddressValidatedinteger · integer · nullableRead-onlyRequired

Whether or not email address has been confirmed

phoneNumberstring · nullableOptional

Phone number. Either this or phoneNumberMobile is required

phoneNumberMobilestring · nullableOptional

Mobile phone number. Either this or phoneNumber is required

languageinteger · integerRequired

Preferred language: 0 - english, 1 - dutch

emailAddressAbusestring · nullableOptional

Email address for abuse emails

newsletterinteger · integer · nullableOptional

Whether or not newsletter is subscribed to

agreeTocinteger · integer · nullableOptional

Whether or not Terms and Conditions are agreed to. Cannot be changed after agreeing.

agreeAupinteger · integer · nullableOptional

Whether or not Acceptable Use Policy is agreed to. Cannot be changed after agreeing.

agreeDpainteger · integer · nullableRequired

Whether or not Data Processing Agreement is agreed to. Cannot be changed after agreeing.

isAllowedFlexMetalinteger · integerRequired

Whether or not the user is allowed to order flexmetal servers.

get
/v3/account/details

Update account details

put
Authorizations
PRIVATE-TOKENstringRequired
Body
accountTypeinteger · integerRequired

Account type: 1 - consumer, 2 - business. Can only be updated by submitting a support ticket.

companyNamestring · nullableOptional

Company name (for business accounts). Can only be updated by submitting a support ticket.

vatNumberstring · nullableOptional

VAT number (for business accounts). Can only be updated by submitting a support ticket.

cocNumberstring · nullableOptional

CoC number (only for Netherlands accounts). Can only be updated by submitting a support ticket.

firstNamestringRequired

First name.

lastNamestringRequired

Last name.

addressstringRequired

Address - street name.

streetNumberstringRequired

House number

zipCodestringRequired

ZIP / Post code.

citystringRequired

City.

countryCodestringRequired

Country code in ISO 3166-1 alpha-2 format.

emailAddressstringRead-onlyRequired

Email address

emailAddressValidatedinteger · integer · nullableRead-onlyRequired

Whether or not email address has been confirmed

phoneNumberstring · nullableOptional

Phone number. Either this or phoneNumberMobile is required

phoneNumberMobilestring · nullableOptional

Mobile phone number. Either this or phoneNumber is required

languageinteger · integerRequired

Preferred language: 0 - english, 1 - dutch

emailAddressAbusestring · nullableOptional

Email address for abuse emails

newsletterinteger · integer · nullableOptional

Whether or not newsletter is subscribed to

agreeTocinteger · integer · nullableOptional

Whether or not Terms and Conditions are agreed to. Cannot be changed after agreeing.

agreeAupinteger · integer · nullableOptional

Whether or not Acceptable Use Policy is agreed to. Cannot be changed after agreeing.

agreeDpainteger · integer · nullableRequired

Whether or not Data Processing Agreement is agreed to. Cannot be changed after agreeing.

isAllowedFlexMetalinteger · integerRequired

Whether or not the user is allowed to order flexmetal servers.

Responses
chevron-right
200

OK

application/json
accountTypeinteger · integerRequired

Account type: 1 - consumer, 2 - business. Can only be updated by submitting a support ticket.

companyNamestring · nullableOptional

Company name (for business accounts). Can only be updated by submitting a support ticket.

vatNumberstring · nullableOptional

VAT number (for business accounts). Can only be updated by submitting a support ticket.

cocNumberstring · nullableOptional

CoC number (only for Netherlands accounts). Can only be updated by submitting a support ticket.

firstNamestringRequired

First name.

lastNamestringRequired

Last name.

addressstringRequired

Address - street name.

streetNumberstringRequired

House number

zipCodestringRequired

ZIP / Post code.

citystringRequired

City.

countryCodestringRequired

Country code in ISO 3166-1 alpha-2 format.

emailAddressstringRead-onlyRequired

Email address

emailAddressValidatedinteger · integer · nullableRead-onlyRequired

Whether or not email address has been confirmed

phoneNumberstring · nullableOptional

Phone number. Either this or phoneNumberMobile is required

phoneNumberMobilestring · nullableOptional

Mobile phone number. Either this or phoneNumber is required

languageinteger · integerRequired

Preferred language: 0 - english, 1 - dutch

emailAddressAbusestring · nullableOptional

Email address for abuse emails

newsletterinteger · integer · nullableOptional

Whether or not newsletter is subscribed to

agreeTocinteger · integer · nullableOptional

Whether or not Terms and Conditions are agreed to. Cannot be changed after agreeing.

agreeAupinteger · integer · nullableOptional

Whether or not Acceptable Use Policy is agreed to. Cannot be changed after agreeing.

agreeDpainteger · integer · nullableRequired

Whether or not Data Processing Agreement is agreed to. Cannot be changed after agreeing.

isAllowedFlexMetalinteger · integerRequired

Whether or not the user is allowed to order flexmetal servers.

put
/v3/account/details

Update the primary email address

put
Authorizations
PRIVATE-TOKENstringRequired
Body
emailAddressstringRequired

New email address

passwordstringRequired

Password of the user account

Responses
put
/v3/account/email/change

No content

Fetch account billing details

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
firstNamestringRequired

Billing first name.

lastNamestringRequired

Billing last name.

addressstringRequired

Billing address.

streetNumberstringRequired

Billing street number.

zipCodestringRequired

Billing ZIP code.

citystringRequired

Billing city.

countryCodestringRequired

Country code in ISO 3166-1 alpha-2 format.

phoneNumberstring · nullableOptional

Billing phone number. Either this or phoneNumberMobile is required.

phoneNumberMobilestring · nullableOptional

Billing mobile phone number. Either this or phoneNumber is required.

emailAddressBillingstring · nullableOptional

Email address for billing emails

bundleInvoicesOfSameCategoryinteger · integerRequired

Whether or not to bundle invoices of the same category

receivePaymentConfirmationsViaEmailinteger · integerRequired

Whether or not to send email confirmations via email

preferredPaymentMethodinteger · integerRequired

Preferred payment method

get
/v3/account/billing

Update account billing details

put
Authorizations
PRIVATE-TOKENstringRequired
Body
firstNamestringRequired

Billing first name.

lastNamestringRequired

Billing last name.

addressstringRequired

Billing address.

streetNumberstringRequired

Billing street number.

zipCodestringRequired

Billing ZIP code.

citystringRequired

Billing city.

countryCodestringRequired

Country code in ISO 3166-1 alpha-2 format.

phoneNumberstring · nullableOptional

Billing phone number. Either this or phoneNumberMobile is required.

phoneNumberMobilestring · nullableOptional

Billing mobile phone number. Either this or phoneNumber is required.

emailAddressBillingstring · nullableOptional

Email address for billing emails

bundleInvoicesOfSameCategoryinteger · integerRequired

Whether or not to bundle invoices of the same category

receivePaymentConfirmationsViaEmailinteger · integerRequired

Whether or not to send email confirmations via email

preferredPaymentMethodinteger · integerRequired

Preferred payment method

Responses
chevron-right
200

OK

application/json
firstNamestringRequired

Billing first name.

lastNamestringRequired

Billing last name.

addressstringRequired

Billing address.

streetNumberstringRequired

Billing street number.

zipCodestringRequired

Billing ZIP code.

citystringRequired

Billing city.

countryCodestringRequired

Country code in ISO 3166-1 alpha-2 format.

phoneNumberstring · nullableOptional

Billing phone number. Either this or phoneNumberMobile is required.

phoneNumberMobilestring · nullableOptional

Billing mobile phone number. Either this or phoneNumber is required.

emailAddressBillingstring · nullableOptional

Email address for billing emails

bundleInvoicesOfSameCategoryinteger · integerRequired

Whether or not to bundle invoices of the same category

receivePaymentConfirmationsViaEmailinteger · integerRequired

Whether or not to send email confirmations via email

preferredPaymentMethodinteger · integerRequired

Preferred payment method

put
/v3/account/billing

Get a list of account action log

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
remoteIPstringRead-onlyRequired

Remote ip address

titlestringRead-onlyRequired

Title Of The action

descriptionstringRead-onlyRequired

A description about the action

datestringRead-onlyRequiredDeprecated

Log creation date

timestringRead-onlyRequiredDeprecated

Log creation time

timestampinteger · integerRead-onlyRequired

The unix time at which the log was created

get
/v3/account/log

List all API keys

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

API key ID

categoryinteger · integerRequired

API key access category

keystringRead-onlyRequired

API key

notestring · nullableOptional

API key note

assignOdpServerIpsinteger · integerRequired

Whether or not to assign ODP server IPs

usedinteger · integerRead-onlyRequired

Number of times that the API key was used

expiresAtinteger · integer · nullableOptional

API key expiration time as UNIX timestamp

get
/v3/account/apiKey

Generate API key

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idinteger · integerRead-onlyRequired

API key ID

categoryinteger · integerRequired

API key access category

keystringRead-onlyRequired

API key

notestring · nullableOptional

API key note

assignOdpServerIpsinteger · integerRequired

Whether or not to assign ODP server IPs

usedinteger · integerRead-onlyRequired

Number of times that the API key was used

expiresAtinteger · integer · nullableOptional

API key expiration time as UNIX timestamp

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

API key ID

categoryinteger · integerRequired

API key access category

keystringRead-onlyRequired

API key

notestring · nullableOptional

API key note

assignOdpServerIpsinteger · integerRequired

Whether or not to assign ODP server IPs

usedinteger · integerRead-onlyRequired

Number of times that the API key was used

expiresAtinteger · integer · nullableOptional

API key expiration time as UNIX timestamp

post
/v3/account/apiKey

Update API key

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
apiKeyIdintegerRequired

ID of API key to update

Body
idinteger · integerRead-onlyRequired

API key ID

categoryinteger · integerRequired

API key access category

keystringRead-onlyRequired

API key

notestring · nullableOptional

API key note

assignOdpServerIpsinteger · integerRequired

Whether or not to assign ODP server IPs

usedinteger · integerRead-onlyRequired

Number of times that the API key was used

expiresAtinteger · integer · nullableOptional

API key expiration time as UNIX timestamp

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

API key ID

categoryinteger · integerRequired

API key access category

keystringRead-onlyRequired

API key

notestring · nullableOptional

API key note

assignOdpServerIpsinteger · integerRequired

Whether or not to assign ODP server IPs

usedinteger · integerRead-onlyRequired

Number of times that the API key was used

expiresAtinteger · integer · nullableOptional

API key expiration time as UNIX timestamp

put
/v3/account/apiKey/{apiKeyId}

Delete API key

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
apiKeyIdintegerRequired

ID of API key to delete

Responses
delete
/v3/account/apiKey/{apiKeyId}

No content

Get all whitelist IP ranges

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
apiKeyIdintegerRequired

ID of API key

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Whitelist ID

ipStartstring · nullableOptional

Start IP of API key IP whitelist range

ipEndstring · nullableOptional

End IP of API key IP whitelist range

ipRangestring · nullableOptional

CIDR IP range of API key whitelist

commentsstring · nullableOptional

IP whitelist range comments

activeinteger · integerRequired

Whether or not this IP whitelist range is active

updatedAtinteger · integerRead-onlyRequired

Last time this IP whitelist range was updated

get
/v3/account/apiKey/{apiKeyId}/whitelist

Add IP range to the whitelist

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
apiKeyIdintegerRequired

ID of API key

Body
idinteger · integerRead-onlyRequired

Whitelist ID

ipStartstring · nullableOptional

Start IP of API key IP whitelist range

ipEndstring · nullableOptional

End IP of API key IP whitelist range

ipRangestring · nullableOptional

CIDR IP range of API key whitelist

commentsstring · nullableOptional

IP whitelist range comments

activeinteger · integerRequired

Whether or not this IP whitelist range is active

updatedAtinteger · integerRead-onlyRequired

Last time this IP whitelist range was updated

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Whitelist ID

ipStartstring · nullableOptional

Start IP of API key IP whitelist range

ipEndstring · nullableOptional

End IP of API key IP whitelist range

ipRangestring · nullableOptional

CIDR IP range of API key whitelist

commentsstring · nullableOptional

IP whitelist range comments

activeinteger · integerRequired

Whether or not this IP whitelist range is active

updatedAtinteger · integerRead-onlyRequired

Last time this IP whitelist range was updated

post
/v3/account/apiKey/{apiKeyId}/whitelist

Update whitelisted IP range

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
apiKeyIdintegerRequired

ID of API key

apiKeyWhitelistIdintegerRequired

Whitelisted IP range ID

Body
idinteger · integerRead-onlyRequired

Whitelist ID

ipStartstring · nullableOptional

Start IP of API key IP whitelist range

ipEndstring · nullableOptional

End IP of API key IP whitelist range

ipRangestring · nullableOptional

CIDR IP range of API key whitelist

commentsstring · nullableOptional

IP whitelist range comments

activeinteger · integerRequired

Whether or not this IP whitelist range is active

updatedAtinteger · integerRead-onlyRequired

Last time this IP whitelist range was updated

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Whitelist ID

ipStartstring · nullableOptional

Start IP of API key IP whitelist range

ipEndstring · nullableOptional

End IP of API key IP whitelist range

ipRangestring · nullableOptional

CIDR IP range of API key whitelist

commentsstring · nullableOptional

IP whitelist range comments

activeinteger · integerRequired

Whether or not this IP whitelist range is active

updatedAtinteger · integerRead-onlyRequired

Last time this IP whitelist range was updated

put
/v3/account/apiKey/{apiKeyId}/whitelist/{apiKeyWhitelistId}

Delete whitelisted IP range

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
apiKeyIdintegerRequired

ID of API key

apiKeyWhitelistIdintegerRequired

Whitelisted IP range ID

Responses
delete
/v3/account/apiKey/{apiKeyId}/whitelist/{apiKeyWhitelistId}

No content

Get all whitelist IP ranges

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

IP whitelist ID

ipStartstring · nullableOptional

First IP in range

ipEndstring · nullableOptional

Last IP in range

ipRangestring · nullableOptional

IP range with network suffix such as /24, /32, etc.

descriptionstringOptional

Description of whitelisted IP or range

activeinteger · integerRequired

Whether or not this whitelist entry is active

createdAtinteger · integerRead-onlyRequired

Unix timestamp of when the IP whitelisting was created

get
/v3/account/whitelist

Add IP range to the whitelist

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idinteger · integerRead-onlyRequired

IP whitelist ID

ipStartstring · nullableOptional

First IP in range

ipEndstring · nullableOptional

Last IP in range

ipRangestring · nullableOptional

IP range with network suffix such as /24, /32, etc.

descriptionstringOptional

Description of whitelisted IP or range

activeinteger · integerRequired

Whether or not this whitelist entry is active

createdAtinteger · integerRead-onlyRequired

Unix timestamp of when the IP whitelisting was created

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

IP whitelist ID

ipStartstring · nullableOptional

First IP in range

ipEndstring · nullableOptional

Last IP in range

ipRangestring · nullableOptional

IP range with network suffix such as /24, /32, etc.

descriptionstringOptional

Description of whitelisted IP or range

activeinteger · integerRequired

Whether or not this whitelist entry is active

createdAtinteger · integerRead-onlyRequired

Unix timestamp of when the IP whitelisting was created

post
/v3/account/whitelist

Update whitelisted IP range

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
whitelistIdintegerRequired

Whitelisted IP range ID

Body
idinteger · integerRead-onlyRequired

IP whitelist ID

ipStartstring · nullableOptional

First IP in range

ipEndstring · nullableOptional

Last IP in range

ipRangestring · nullableOptional

IP range with network suffix such as /24, /32, etc.

descriptionstringOptional

Description of whitelisted IP or range

activeinteger · integerRequired

Whether or not this whitelist entry is active

createdAtinteger · integerRead-onlyRequired

Unix timestamp of when the IP whitelisting was created

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

IP whitelist ID

ipStartstring · nullableOptional

First IP in range

ipEndstring · nullableOptional

Last IP in range

ipRangestring · nullableOptional

IP range with network suffix such as /24, /32, etc.

descriptionstringOptional

Description of whitelisted IP or range

activeinteger · integerRequired

Whether or not this whitelist entry is active

createdAtinteger · integerRead-onlyRequired

Unix timestamp of when the IP whitelisting was created

put
/v3/account/whitelist/{whitelistId}

Delete whitelisted IP range

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
whitelistIdintegerRequired

Whitelisted IP range ID

Responses
delete
/v3/account/whitelist/{whitelistId}

No content

Check user whitelist

post
Authorizations
PRIVATE-TOKENstringRequired
Responses
post
/v3/account/whitelist/check

No content

List all files

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

File ID

categoryinteger · integerRequired

ID of the category of the file

namestringRequired

File display name

filenamestringRequired

Name of the file

typestringRead-onlyRequired

File MIME type

sizeinteger · integerRead-onlyRequired

File size in bytes

uploadedAtinteger · integerRead-onlyRequired

UNIX timestamp of when the file was uploaded

get
/v3/account/files

Download the file

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
fileIdintegerRequired

ID of the file to download

Responses
chevron-right
200

fileContent

application/json
stringOptional
get
/v3/account/files/{fileId}/download

Get all the documents

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

get
/v3/account/document

Create a new document

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

post
/v3/account/document

Delete a document.

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
documentIdintegerRequired

Id of the document to delete.

Responses
delete
/v3/account/document/{documentId}

No content

Get list of all colocation access

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
statusstringOptional

Example /v3/colocation/access?status=revoked

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of colocation access request

visitorIdinteger · integerRequired

The ID of the user

datacenterIdinteger · integer · nullableOptional

The ID of data center

dateverifiedstring · nullableOptional

The date when the user was verified

dateonliststring · nullableOptional

The date when the user was added to the access list

dateoffliststring · nullableOptional

The date when the user was removed from the access list

emailstringRequired

The e-mail address of the visitor

mobilestringRequired

The mobile phone number of the visitor

firstNamestringRequired

The first name of the visitor

lastNamestringRequired

The last name of the visitor

birthDatestringRequired

The birth date of the user. The format is YYYY-MM-DD

companyNamestring · nullableOptional

The company name of the visitor

citystring · nullableOptional

The city of the visitor

countryEnstringRead-onlyRequired

The country name of the visitor

adminNotesReadOnlystring · nullableOptional

Notes for admins

checkedstring · nullableOptional

Was the user checked?

createdByinteger · integerRead-onlyRequired

ID of user creator

newEntryinteger · integerRead-onlyRequired

Is this a new entry

temporaryAccessinteger · integer · nullableOptional

temporaryAccess If this field is set to 1, then has the visitor a temporary access

fingerPrintIdinteger · integer · nullableOptional

The print ID from Syntegro system

printMadestring · nullableOptional

Was the print made

visitRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can add a temporary access for other visitor

permanentRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can request a permanent access for other visitor

syntegroEmployeeCodestring · nullableOptional

The Syntegro employee code of visitor

statusstringRead-onlyRequired

The status of the visitor (granted, pending, denied, revoked, suspended)

get
/v3/colocation/access

Create a new colocation access request

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idinteger · integerRead-onlyRequired

The ID of colocation access request

visitorIdinteger · integerOptional

The ID of the visitor

emailstringRequired

The e-mail address of the visitor

mobilestringRequired

The mobile phone number of the visitor

firstNamestringRequired

The first name of the visitor

lastNamestringRequired

The last name of the visitor

birthDatestringRequired

The birth date of the visitor

companyNamestringRequired

The company name of visitor

temporaryAccessinteger · integer · nullableOptional

If this field is set to 1, then the visitor has a temporary access

visitRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can add a temporary access for other visitor

permanentRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can request a permanent access for other visitor

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of colocation access request

visitorIdinteger · integerRequired

The ID of the user

datacenterIdinteger · integer · nullableOptional

The ID of data center

dateverifiedstring · nullableOptional

The date when the user was verified

dateonliststring · nullableOptional

The date when the user was added to the access list

dateoffliststring · nullableOptional

The date when the user was removed from the access list

emailstringRequired

The e-mail address of the visitor

mobilestringRequired

The mobile phone number of the visitor

firstNamestringRequired

The first name of the visitor

lastNamestringRequired

The last name of the visitor

birthDatestringRequired

The birth date of the user. The format is YYYY-MM-DD

companyNamestring · nullableOptional

The company name of the visitor

citystring · nullableOptional

The city of the visitor

countryEnstringRead-onlyRequired

The country name of the visitor

adminNotesReadOnlystring · nullableOptional

Notes for admins

checkedstring · nullableOptional

Was the user checked?

createdByinteger · integerRead-onlyRequired

ID of user creator

newEntryinteger · integerRead-onlyRequired

Is this a new entry

temporaryAccessinteger · integer · nullableOptional

temporaryAccess If this field is set to 1, then has the visitor a temporary access

fingerPrintIdinteger · integer · nullableOptional

The print ID from Syntegro system

printMadestring · nullableOptional

Was the print made

visitRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can add a temporary access for other visitor

permanentRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can request a permanent access for other visitor

syntegroEmployeeCodestring · nullableOptional

The Syntegro employee code of visitor

statusstringRead-onlyRequired

The status of the visitor (granted, pending, denied, revoked, suspended)

post
/v3/colocation/access

Get colocation access by ID

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

ID of the access

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of colocation access request

visitorIdinteger · integerRequired

The ID of the user

datacenterIdinteger · integer · nullableOptional

The ID of data center

dateverifiedstring · nullableOptional

The date when the user was verified

dateonliststring · nullableOptional

The date when the user was added to the access list

dateoffliststring · nullableOptional

The date when the user was removed from the access list

emailstringRequired

The e-mail address of the visitor

mobilestringRequired

The mobile phone number of the visitor

firstNamestringRequired

The first name of the visitor

lastNamestringRequired

The last name of the visitor

birthDatestringRequired

The birth date of the user. The format is YYYY-MM-DD

companyNamestring · nullableOptional

The company name of the visitor

citystring · nullableOptional

The city of the visitor

countryEnstringRead-onlyRequired

The country name of the visitor

adminNotesReadOnlystring · nullableOptional

Notes for admins

checkedstring · nullableOptional

Was the user checked?

createdByinteger · integerRead-onlyRequired

ID of user creator

newEntryinteger · integerRead-onlyRequired

Is this a new entry

temporaryAccessinteger · integer · nullableOptional

temporaryAccess If this field is set to 1, then has the visitor a temporary access

fingerPrintIdinteger · integer · nullableOptional

The print ID from Syntegro system

printMadestring · nullableOptional

Was the print made

visitRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can add a temporary access for other visitor

permanentRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can request a permanent access for other visitor

syntegroEmployeeCodestring · nullableOptional

The Syntegro employee code of visitor

statusstringRead-onlyRequired

The status of the visitor (granted, pending, denied, revoked, suspended)

get
/v3/colocation/access/{accessId}

Update colocation access

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

ID of the access

Body
idinteger · integerRead-onlyRequired

The ID of colocation access request

visitorIdinteger · integerOptional

The ID of the visitor

emailstringRequired

The e-mail address of the visitor

mobilestringRequired

The mobile phone number of the visitor

firstNamestringRequired

The first name of the visitor

lastNamestringRequired

The last name of the visitor

birthDatestringRequired

The birth date of the visitor

companyNamestringRequired

The company name of visitor

temporaryAccessinteger · integer · nullableOptional

If this field is set to 1, then the visitor has a temporary access

visitRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can add a temporary access for other visitor

permanentRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can request a permanent access for other visitor

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of colocation access request

visitorIdinteger · integerRequired

The ID of the user

datacenterIdinteger · integer · nullableOptional

The ID of data center

dateverifiedstring · nullableOptional

The date when the user was verified

dateonliststring · nullableOptional

The date when the user was added to the access list

dateoffliststring · nullableOptional

The date when the user was removed from the access list

emailstringRequired

The e-mail address of the visitor

mobilestringRequired

The mobile phone number of the visitor

firstNamestringRequired

The first name of the visitor

lastNamestringRequired

The last name of the visitor

birthDatestringRequired

The birth date of the user. The format is YYYY-MM-DD

companyNamestring · nullableOptional

The company name of the visitor

citystring · nullableOptional

The city of the visitor

countryEnstringRead-onlyRequired

The country name of the visitor

adminNotesReadOnlystring · nullableOptional

Notes for admins

checkedstring · nullableOptional

Was the user checked?

createdByinteger · integerRead-onlyRequired

ID of user creator

newEntryinteger · integerRead-onlyRequired

Is this a new entry

temporaryAccessinteger · integer · nullableOptional

temporaryAccess If this field is set to 1, then has the visitor a temporary access

fingerPrintIdinteger · integer · nullableOptional

The print ID from Syntegro system

printMadestring · nullableOptional

Was the print made

visitRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can add a temporary access for other visitor

permanentRequesterinteger · integer · nullableOptional

If this field is set to 1, then this visitor can request a permanent access for other visitor

syntegroEmployeeCodestring · nullableOptional

The Syntegro employee code of visitor

statusstringRead-onlyRequired

The status of the visitor (granted, pending, denied, revoked, suspended)

put
/v3/colocation/access/{accessId}

Delete colocation access by ID

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

Responses
delete
/v3/colocation/access/{accessId}

No content

Revoke access by access ID

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

Responses
put
/v3/colocation/access/{accessId}/revoke

No content

Reactivate access by access ID

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

Responses
put
/v3/colocation/access/{accessId}/reactivate

No content

Get all the documents of the DC access visitor

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

get
/v3/colocation/access/{accessId}/document

Create a new document for the visitor accessing DC

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

Body
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

post
/v3/colocation/access/{accessId}/document

Get a document of the DC access visitor

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

documentIdintegerRequired

The ID of the document to view

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

get
/v3/colocation/access/{accessId}/document/{documentId}

Update document of the DC access visitor

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

documentIdintegerRequired

The ID of the document to update

Body
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the document

documentTypeinteger · integerRequired

Type of the document

documentNumberstringRequired

Number of document

documentExpirationstringRequired

Expiration date of document

put
/v3/colocation/access/{accessId}/document/{documentId}

Delete a document of the visitor accessing DC

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
accessIdintegerRequired

The ID of the access

documentIdintegerRequired

The ID of the document to delete

Responses
delete
/v3/colocation/access/{accessId}/document/{documentId}

No content

List all services

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

The ID of the service

servicestringRead-onlyRequired

The name of the service

amountinteger · integerRead-onlyRequired

The amount of service the customer has

get
/v3/dashboard/service

Get the status of the platform

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
statusinteger · integerRead-onlyRequired

The status of all the systems

  • 1: All systems operational
  • 2: Multiple systems have performance issues
  • 3: Multiple systems are offline
  • 4: All systems are offline
get
/v3/dashboard/status

Get the detail of the trigger

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
triggerIdstringRequired

The ID of the trigger for which to fetch the information

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
get
/v3/trigger/{triggerId}

Update the details of a trigger

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
triggerIdstringRequired

The ID of the trigger

Body
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
put
/v3/trigger/{triggerId}

Delete a trigger

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
triggerIdstringRequired

The ID of the trigger

Responses
delete
/v3/trigger/{triggerId}

No content

Get the list of all the triggers

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
get
/v3/trigger/

Get the summary of all the triggers, only id, name and description

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the type

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

get
/v3/trigger/summary

Create a trigger

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
post
/v3/trigger

Enable a trigger

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
triggerIdstringRequired

The ID of the trigger

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
put
/v3/trigger/{triggerId}/enable

Disable a trigger

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
triggerIdstringRequired

The ID of the trigger

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

ID of the the trigger

namestringRequired

The name of the trigger

descriptionstringOptional

The description of the trigger

createdAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been created.

changedAtinteger · integerRead-onlyRequired

The unix timestamp when the trigger has been changed.

activeinteger · integerRead-onlyRequired

Status of the trigger

  • 1 the trigger is enabled
  • 0 the trigger is disabled
put
/v3/trigger/{triggerId}/disable

Get list of rule action types

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the type

descriptionstringRead-onlyRequired

The description of the type

get
/v3/trigger/type/ruleActions

Get list of rule data types

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the type

descriptionstringRead-onlyRequired

The description of the type

get
/v3/trigger/type/ruleDataTypes

Get list of actions types

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the type

descriptionstringRead-onlyRequired

The description of the type

get
/v3/trigger/type/actions

Get list of operators

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the type

descriptionstringRead-onlyRequired

The description of the type

get
/v3/trigger/type/operators

Get list of conditions

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the type

descriptionstringRead-onlyRequired

The description of the type

get
/v3/trigger/type/conditions

Get list of valueTypes

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the type

descriptionstringRead-onlyRequired

The description of the type

get
/v3/trigger/type/valueTypes

List SSH keys

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
uuidstringRead-onlyRequired

SSH key UUID as specified in RFC 4122

Example: 7561c39d-f4df-4c46-b3f1-2ac981271e29
namestringRequired

SSH key name

publicKeystringRequired

Public SSH key contents

createdAtinteger · integerRead-onlyRequired

SSH key createdAt

get
/v3/sshKey

Upload a new SSH key

post

Note: Please always upload a public(!) key and preferably in OpenSSH format.

Authorizations
PRIVATE-TOKENstringRequired
Body
uuidstringRead-onlyRequired

SSH key UUID as specified in RFC 4122

Example: 7561c39d-f4df-4c46-b3f1-2ac981271e29
namestringRequired

SSH key name

publicKeystringRequired

Public SSH key contents

createdAtinteger · integerRead-onlyRequired

SSH key createdAt

Responses
chevron-right
200

OK

application/json
uuidstringRead-onlyRequired

SSH key UUID as specified in RFC 4122

Example: 7561c39d-f4df-4c46-b3f1-2ac981271e29
namestringRequired

SSH key name

publicKeystringRequired

Public SSH key contents

createdAtinteger · integerRead-onlyRequired

SSH key createdAt

post
/v3/sshKey

SSH key by ID

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
uuidstringRead-onlyRequired

SSH key UUID as specified in RFC 4122

Example: 7561c39d-f4df-4c46-b3f1-2ac981271e29
namestringRequired

SSH key name

publicKeystringRequired

Public SSH key contents

createdAtinteger · integerRead-onlyRequired

SSH key createdAt

get
/v3/sshKey/{uuid}

Delete SSH key

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
uuidstringRequired

SSH key UUID

Example: 7561c39d-f4df-4c46-b3f1-2ac981271e29
Responses
delete
/v3/sshKey/{uuid}

No content

Get users geo heatmap data

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
typestringRequired
get
/v3/internalServices/heatmapData

Get the list of all currenties

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Currency ID

namestringRead-onlyRequired

Currency Name

signstringOptional

Currency Sign

conversionRateToEuronumber · floatRead-onlyRequired

Exchange rate to Euro

decimalsinteger · integerRead-onlyRequired

Number of decimals

get
/v3/currency

Get all your FlexMetal servers

get
Authorizations
PRIVATE-TOKENstringRequired
Query parameters
statusstringRequired

Filter by status [creating, provisioning, delivered, failed, releasing, released]

taganyRequired

Filter by one or more server tags (only servers with all tags will be returned)

Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
uuidstringRead-onlyRequired

Server UUID.

Example: 019256ab-1554-73a7-b091-f024b0a724ea
namestringRequired

Server host name.

Example: host.example.com
statusstringRead-onlyRequired

Server delivery status.

    • created
      discovering
      discovered
      allocating
      allocated
      configuring_network
      network_configured
      provisioning
      provisioned
      delivered
      failed
      releasing
      released
  • Example: delivered
    statusMessagestringRead-onlyRequired

    Status message.

    Example: OK
    tagsstring[]Read-onlyRequired

    Server tags.

    Example: my-tag
    createdAtinteger · integerRead-onlyRequired

    Server creation timestamp.

    Example: 1728030905
    deliveredAtinteger · integerRead-onlyRequired

    Server delivery timestamp.

    Example: 1728031748
    releasedAtinteger · integerRead-onlyRequired

    Server release timestamp.

    contractIdstringRead-onlyRequired

    Represents client contractId.

    Example: MY-CONTRACT-123
    get
    /v3/flexMetal/servers

    Create a new FlexMetal server

    post
    Authorizations
    PRIVATE-TOKENstringRequired
    Body

    Request object for creating a new Flex Metal server

    namestringRequired

    Server name or hostname, depending on the chosen OS. E.g. Talos requires a hostname but regular Linux OSs work with either.

    Example: host.example.com
    locationstringRequired

    Server location. Available locations can be obtained from /v3/flexMetal/location. Use the name field from the response.

    instanceTypestringRequired

    Server instance type. Available instance types can be obtained from /v3/flexMetal/location/{locationId}}/instanceTypes. Use the name field from the response.

    Example: bm7.std.8
    sshKeystring[]Required

    A list of SSH keys. You can either supply SSH key UUIDs from stored objects in /v3/sshKey or provide public keys directly. SSH keys are installed for the root user.

    Example: ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBHo8IaPkQ6UnDZvi4F4RBSouRa6Gtysdg2EF+SIXheVF2SGBQ2uH7RfDjXRfvq4VpHJrKYs4kWfNoHQg8ZG6PH4= ecdsa-key-20240131
    postInstallScriptstringOptional

    Post install script. A shell script (e.g. bash) that will be executed after your OS is installed. Currently only supported for Linux based operating systems.

    Example: #!/bin/bash echo "Hello world!" > /root/blah.txt
    tagsstring[]Optional

    A list of tags. There is a maximum of 60 tags per server. Each tag must adhere to this pattern: ^[A-Za-z0-9_:-]{1,64}$

    Example: my-tag
    contractIdstringOptional

    Represents client contractId. Format is ^[A-Z0-9_-.]{0,240}$

    Example: MY-CONTRACT-123
    overflowbooleanOptional

    If true, the server will be created even if the location is at commited capacity. Default is false.

    Example: true
    Responses
    chevron-right
    200

    OK

    application/json
    uuidstringRead-onlyRequired

    Server UUID.

    Example: 019256ab-1554-73a7-b091-f024b0a724ea
    namestringRequired

    Server host name.

    Example: host.example.com
    statusstringRead-onlyRequired

    Server delivery status.

    • created
      discovering
      discovered
      allocating
      allocated
      configuring_network
      network_configured
      provisioning
      provisioned
      delivered
      failed
      releasing
      released
  • Example: delivered
    statusMessagestringRead-onlyRequired

    Status message.

    Example: OK
    tagsstring[]Read-onlyRequired

    Server tags.

    Example: my-tag
    createdAtinteger · integerRead-onlyRequired

    Server creation timestamp.

    Example: 1728030905
    deliveredAtinteger · integerRead-onlyRequired

    Server delivery timestamp.

    Example: 1728031748
    releasedAtinteger · integerRead-onlyRequired

    Server release timestamp.

    contractIdstringRead-onlyRequired

    Represents client contractId.

    Example: MY-CONTRACT-123
    post
    /v3/flexMetal/servers

    Get a specific FlexMetal server

    get
    Authorizations
    PRIVATE-TOKENstringRequired
    Path parameters
    uuidstringRequired

    The server identifier

    Responses
    chevron-right
    200

    OK

    application/json
    uuidstringRead-onlyRequired

    Server UUID.

    Example: 019256ab-1554-73a7-b091-f024b0a724ea
    namestringRequired

    Server host name.

    Example: host.example.com
    statusstringRead-onlyRequired

    Server delivery status.

    • created
      discovering
      discovered
      allocating
      allocated
      configuring_network
      network_configured
      provisioning
      provisioned
      delivered
      failed
      releasing
      released
  • Example: delivered
    statusMessagestringRead-onlyRequired

    Status message.

    Example: OK
    tagsstring[]Read-onlyRequired

    Server tags.

    Example: my-tag
    createdAtinteger · integerRead-onlyRequired

    Server creation timestamp.

    Example: 1728030905
    deliveredAtinteger · integerRead-onlyRequired

    Server delivery timestamp.

    Example: 1728031748
    releasedAtinteger · integerRead-onlyRequired

    Server release timestamp.

    contractIdstringRead-onlyRequired

    Represents client contractId.

    Example: MY-CONTRACT-123
    get
    /v3/flexMetal/servers/{uuid}

    Release a FlexMetal server

    delete
    Authorizations
    PRIVATE-TOKENstringRequired
    Path parameters
    uuidstringRequired

    The server identifier

    Responses
    chevron-right
    200

    OK

    application/json
    uuidstringRead-onlyRequired

    Server UUID.

    Example: 019256ab-1554-73a7-b091-f024b0a724ea
    namestringRequired

    Server host name.

    Example: host.example.com
    statusstringRead-onlyRequired

    Server delivery status.

    • created
      discovering
      discovered
      allocating
      allocated
      configuring_network
      network_configured
      provisioning
      provisioned
      delivered
      failed
      releasing
      released
  • Example: delivered
    statusMessagestringRead-onlyRequired

    Status message.

    Example: OK
    tagsstring[]Read-onlyRequired

    Server tags.

    Example: my-tag
    createdAtinteger · integerRead-onlyRequired

    Server creation timestamp.

    Example: 1728030905
    deliveredAtinteger · integerRead-onlyRequired

    Server delivery timestamp.

    Example: 1728031748
    releasedAtinteger · integerRead-onlyRequired

    Server release timestamp.

    contractIdstringRead-onlyRequired

    Represents client contractId.

    Example: MY-CONTRACT-123
    delete
    /v3/flexMetal/servers/{uuid}

    Get a FlexMetal server's root password

    get

    Windows only: Fetch the root password within the first 24 hours after installation.

    Authorizations
    PRIVATE-TOKENstringRequired
    Path parameters
    uuidstringRequired

    The server identifier

    Responses
    chevron-right
    200

    OK

    application/json
    rootPasswordstringRequired

    Server root password.

    get
    /v3/flexMetal/servers/{uuid}/rootPassword

    Add a tag to a FlexMetal server

    post
    Authorizations
    PRIVATE-TOKENstringRequired
    Path parameters
    uuidstringRequired

    The server identifier

    tagstringRequired

    The tag to add to the server

    Responses
    chevron-right
    200

    OK

    application/json
    uuidstringRead-onlyRequired

    Server UUID.

    Example: 019256ab-1554-73a7-b091-f024b0a724ea
    namestringRequired

    Server host name.

    Example: host.example.com
    statusstringRead-onlyRequired

    Server delivery status.

    • created
      discovering
      discovered
      allocating
      allocated
      configuring_network
      network_configured
      provisioning
      provisioned
      delivered
      failed
      releasing
      released
  • Example: delivered
    statusMessagestringRead-onlyRequired

    Status message.

    Example: OK
    tagsstring[]Read-onlyRequired

    Server tags.

    Example: my-tag
    createdAtinteger · integerRead-onlyRequired

    Server creation timestamp.

    Example: 1728030905
    deliveredAtinteger · integerRead-onlyRequired

    Server delivery timestamp.

    Example: 1728031748
    releasedAtinteger · integerRead-onlyRequired

    Server release timestamp.

    contractIdstringRead-onlyRequired

    Represents client contractId.

    Example: MY-CONTRACT-123
    post
    /v3/flexMetal/servers/{uuid}/tag/{tag}

    Remove a tag from a FlexMetal server

    delete
    Authorizations
    PRIVATE-TOKENstringRequired
    Path parameters
    uuidstringRequired

    The server identifier

    tagstringRequired

    The tag to remove from the server

    Responses
    chevron-right
    200

    OK

    application/json
    uuidstringRead-onlyRequired

    Server UUID.

    Example: 019256ab-1554-73a7-b091-f024b0a724ea
    namestringRequired

    Server host name.

    Example: host.example.com
    statusstringRead-onlyRequired

    Server delivery status.

    • created
      discovering
      discovered
      allocating
      allocated
      configuring_network
      network_configured
      provisioning
      provisioned
      delivered
      failed
      releasing
      released
  • Example: delivered
    statusMessagestringRead-onlyRequired

    Status message.

    Example: OK
    tagsstring[]Read-onlyRequired

    Server tags.

    Example: my-tag
    createdAtinteger · integerRead-onlyRequired

    Server creation timestamp.

    Example: 1728030905
    deliveredAtinteger · integerRead-onlyRequired

    Server delivery timestamp.

    Example: 1728031748
    releasedAtinteger · integerRead-onlyRequired

    Server release timestamp.

    contractIdstringRead-onlyRequired

    Represents client contractId.

    Example: MY-CONTRACT-123
    delete
    /v3/flexMetal/servers/{uuid}/tag/{tag}

    Get your FlexMetal capacity commits and usage

    get
    Authorizations
    PRIVATE-TOKENstringRequired
    Responses
    chevron-right
    200

    OK

    application/json
    get
    /v3/flexMetal/capacity/commit

    Get all your FlexMetal tags

    get
    Authorizations
    PRIVATE-TOKENstringRequired
    Header parameters
    RANGED-DATAstringOptional

    Example header and default range: RANGED-DATA:start=0,results=25

    Responses
    chevron-right
    200

    List of tags

    application/json

    A Flex Metal tag

    tagstringRequired

    The tag name

    Example: my-tag
    get
    /v3/flexMetal/tags

    Create a FlexMetal tag

    post
    Authorizations
    PRIVATE-TOKENstringRequired
    Body

    A Flex Metal tag

    tagstringRequired

    The tag name

    Example: my-tag
    Responses
    chevron-right
    200

    The new tag

    application/json

    A Flex Metal tag

    tagstringRequired

    The tag name

    Example: my-tag
    post
    /v3/flexMetal/tags

    Get a tag by name

    get
    Authorizations
    PRIVATE-TOKENstringRequired
    Responses
    chevron-right
    200

    List of tags

    application/json

    A Flex Metal tag

    tagstringRequired

    The tag name

    Example: my-tag
    get
    /v3/flexMetal/tags/{tag}

    Rename a FlexMetal tag

    put
    Authorizations
    PRIVATE-TOKENstringRequired
    Body

    A Flex Metal tag

    tagstringRequired

    The tag name

    Example: my-tag
    Responses
    chevron-right
    200

    The updated tag model

    application/json

    A Flex Metal tag

    tagstringRequired

    The tag name

    Example: my-tag
    put
    /v3/flexMetal/tags/{tag}

    Delete a FlexMetal tag

    delete
    Authorizations
    PRIVATE-TOKENstringRequired
    Responses
    delete
    /v3/flexMetal/tags/{tag}

    No content

    Get your FlexMetal quota and current usage numbers

    get
    Authorizations
    PRIVATE-TOKENstringRequired
    Responses
    chevron-right
    200

    List of quota & current usage numbers

    application/json
    get
    /v3/flexMetal/quota/usage

    Retrieve a list of FlexMetal server usages

    get
    Authorizations
    PRIVATE-TOKENstringRequired
    Query parameters
    startDatestringOptional

    Must be a valid date string. E.g. YYYY-MM-DD.

    endDatestringOptional

    Must be a valid date string. E.g. YYYY-MM-DD.

    Responses
    chevron-right
    200

    OK

    application/json
    startedAtstring · date-timeRequired

    Usage tracking starts.

    endedAtstring · date-timeRequired

    Usage tracking ends.

    totalHoursinteger · integerRequired

    Total hours of usage.

    totalMinutesinteger · integerRequired

    Total minutes of usage.

    bandwidthIninteger · integerRequired

    Total bandwidth out.

    get
    /v3/flexMetal/usage

    Get all available Bare Metal locations

    get
    Authorizations
    PRIVATE-TOKENstringRequired
    Responses
    chevron-right
    200

    OK

    application/json
    idinteger · integerRead-onlyRequired

    ID of the location

    namestringRead-onlyRequired

    Name of the location

    shortNamestringRead-onlyRequired

    Short name of the location

    displayNamestringRead-onlyRequired

    Display name of the location

    countryIdinteger · integerRead-onlyRequired

    Country ID of the location

    countryNamestringRead-onlyRequired

    Country name of the Location

    countryShortNamestringRead-onlyRequired

    Country short name of the Location

    get
    /v3/flexMetal/location

    Get all instance types for a location.

    get

    For an overview of all locations, see /v3/flexMetal/location

    Authorizations
    PRIVATE-TOKENstringRequired
    Path parameters
    locationIdintegerRequired
    Responses
    chevron-right
    200

    OK

    application/json
    idinteger · integerRead-onlyRequired

    Id of instance type

    locationIdinteger · integerRead-onlyRequired

    LocationId of instance type

    namestringRead-onlyRequired

    Name of instance type

    socketsinteger · integerRead-onlyRequired

    Sockets of instance type

    coresinteger · integerRead-onlyRequired

    Cores of instance type

    memoryinteger · integerRead-onlyRequired

    Memory of instance type

    memoryTypestringRead-onlyRequired

    Memory type of instance type

    storageinteger · integerRead-onlyRequired

    Storage of instance type

    storageTypestringRead-onlyRequired

    Storage type of instance type

    generationNamestringRead-onlyRequired

    Generation name of instance type

    get
    /v3/flexMetal/location/{locationId}/instanceTypes

    Last updated

    Was this helpful?