--- title: "All services and orders" description: "One bridge to every product line (VDS, dedicated, hosting, licenses …): tools, plan changes, add-ons, renewals and orders." url: https://www.gyrohosting.com/developers/en/products/services.html language: en openapi: https://www.gyrohosting.com/developers/openapi.json api_version: 2.30.0 --- # All services and orders One bridge to every product line (VDS, dedicated, hosting, licenses …): tools, plan changes, add-ons, renewals and orders. ## How-to guides - [Every product through one bridge](https://www.gyrohosting.com/developers/en/guides/services.md) ## Services (all products) Generic bridge to every product line (cloud server, VDS, dedicated, mail, monitor, storage, license, ...). Everything a customer can do on a service in the client area is a module tool or method and is reachable here. Start with `GET /cloud/services/{id}/tools`: it lists the tools, their actions and our safety policy (`read`, `confirm`, `secret`) for that very service. - `GET /cloud/services` — [List services of every product line](https://www.gyrohosting.com/developers/en/api/services-all-products.md#listServices) - `GET /cloud/services/{id}` — [Get a service (renewal, cancellation, access details)](https://www.gyrohosting.com/developers/en/api/services-all-products.md#getService) - `GET /cloud/services/{id}/tools` — [Discover tools, actions and safety policy of a service](https://www.gyrohosting.com/developers/en/api/services-all-products.md#listServiceTools) - `GET /cloud/services/{id}/tools/{tool}` — [Read a tool (list mailboxes, snapshots, DNS records, ...)](https://www.gyrohosting.com/developers/en/api/services-all-products.md#getServiceToolData) - `POST /cloud/services/{id}/tools/{tool}/{action}` — [Run a tool action (create a mailbox, restore a snapshot, ...)](https://www.gyrohosting.com/developers/en/api/services-all-products.md#runServiceToolAction) - `POST /cloud/services/{id}/methods/{method}` — [Call a client-callable module method (e.g. license change_ip)](https://www.gyrohosting.com/developers/en/api/services-all-products.md#callServiceMethod) - `GET /cloud/services/{id}/label` — [Get the nickname and tags of a service](https://www.gyrohosting.com/developers/en/api/services-all-products.md#getServiceLabel) - `PUT /cloud/services/{id}/label` — [Set the nickname and/or tags of a service](https://www.gyrohosting.com/developers/en/api/services-all-products.md#updateServiceLabel) ## Services (core) Core service endpoints: renew, cancel, auto-renew, add-ons, metrics, SSO, password. - `GET /services` — [List services](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServices) - `GET /services/{id}` — [Get service (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetService) - `PATCH /services/{id}` — [Update service (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreUpdateService) - `POST /services/{id}/renew` — [Renew service (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreRenewService) - `GET /services/{id}/invoices` — [List service invoices (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceInvoices) - `GET /services/{id}/addons` — [List service addons (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceAddons) - `POST /services/{id}/cancellation` — [Create cancellation (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreCreateCancellation) - `DELETE /services/{id}/cancellation` — [Revoke cancellation (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreRevokeCancellation) - `GET /services/{id}/metrics` — [Get service metrics (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceMetrics) - `GET /services/{id}/metrics/billing` — [List service metric billing (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceMetricBilling) - `PATCH /services/{id}/metrics/{key}` — [Update service metric (path: {id}, {key})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreUpdateServiceMetric) - `GET /services/{id}/dashboard` — [Get service dashboard (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceDashboard) - `GET /services/{id}/tools` — [Get service tools (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceTools) - `GET /services/{id}/tools/{tool}` — [Get service tool data (path: {id}, {tool})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceToolData) - `POST /services/{id}/tools/{tool}/{action}` — [Run service tool action (path: {id}, {tool}, {action})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreRunServiceToolAction) - `POST /services/{id}/module-method` — [Use service module method (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreUseServiceModuleMethod) - `POST /services/{id}/sso` — [Get service sso (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreGetServiceSso) - `POST /services/{id}/password` — [Change service password (path: {id})](https://www.gyrohosting.com/developers/en/api/services-core.md#coreChangeServicePassword) ## Plan changes and add-ons Resize (plan upgrade) and add-on purchase, paid from the account balance (dry_run, confirm, Idempotency-Key, daily limit: default 50 paid operations per account, per-account/reseller override, 429 daily_limit). - `GET /cloud/services/{id}/resize-options` — [Products this service can be upgraded to, with prices](https://www.gyrohosting.com/developers/en/api/plan-changes-and-add-ons.md#getResizeOptions) - `POST /cloud/services/{id}/resize` — [Upgrade the plan (paid from balance)](https://www.gyrohosting.com/developers/en/api/plan-changes-and-add-ons.md#resizeService) - `GET /cloud/services/{id}/addons/available` — [Add-ons offered for this service (with options and prices)](https://www.gyrohosting.com/developers/en/api/plan-changes-and-add-ons.md#listAvailableAddons) - `GET /cloud/services/{id}/addons` — [Add-ons the service holds](https://www.gyrohosting.com/developers/en/api/plan-changes-and-add-ons.md#listServiceAddons) - `POST /cloud/services/{id}/addons` — [Buy an add-on (paid from balance)](https://www.gyrohosting.com/developers/en/api/plan-changes-and-add-ons.md#buyAddon) - `DELETE /cloud/services/{id}/addons/{aid}` — [Remove a prepaid add-on at once](https://www.gyrohosting.com/developers/en/api/plan-changes-and-add-ons.md#removeServiceAddon) ## Licenses Software license status and IP change. - `GET /cloud/licenses/{id}` — [GET method license_status (LisansAPP)](https://www.gyrohosting.com/developers/en/api/licenses.md#typed_get_licenses__id) - `POST /cloud/licenses/{id}/change-ip` — [POST method change_ip (LisansAPP)](https://www.gyrohosting.com/developers/en/api/licenses.md#typed_post_licenses__id__change_ip) ## Orders Preview (quote) and place orders for any product. - `GET /orders` — [List orders](https://www.gyrohosting.com/developers/en/api/orders.md#coreGetOrders) - `POST /orders` — [Create order](https://www.gyrohosting.com/developers/en/api/orders.md#coreCreateOrder) - `POST /orders/preview` — [Preview order](https://www.gyrohosting.com/developers/en/api/orders.md#corePreviewOrder) - `GET /orders/{id}` — [Get order (path: {id})](https://www.gyrohosting.com/developers/en/api/orders.md#coreGetOrder)