Hubfly spaceDocs
Console

Managed Databases API · Dashboard

Catalog & pricing

Read the engines, versions and size presets on offer, price a size before creating it, and inspect the managed services project.

Base URL: https://api.hubfly.space. Use a Dashboard bearer token authorized for the project. Replace :projectId in each path with the Dashboard project ID. JSON routes use Content-Type: application/json.

Database instances live in a project of type managed; other projects return 409 MANAGED_PROJECT_REQUIRED. Replace :instanceId with the database instance ID from the instance list. Each endpoint lists the permission it needs; a token scoped to the database permissions must hold that exact permission.

How to use these endpoints

  1. Read the catalog for the engines, versions, size presets and limits available to you. Hubfly space chooses where an instance runs; there is no region parameter.
  2. Price the size you want with the estimate endpoint. Prices are estimates billed hourly; the quote returned here is the one the create and resize calls check.
  3. Create a project of type managed (or reuse one) and read its workspace to see its instances and recent operations.
  4. Read your client IP when you want to add it to an instance allowlist.

Price a nano instance with 10 GiB

curl
curl "https://api.hubfly.space/api/v1/pricing/managed/estimate?cpu=0.25&memoryMib=512&storageGib=10" \
  -H "Authorization: Bearer $HUBFLY_TOKEN"

The response uses the standard Dashboard envelope: ok, data, and meta on success. On failure, use the returned error code and message to decide whether to correct the request or retry. The exact schema and response codes for each operation are below.

Endpoint reference

Dashboard endpoints (5)

These JSON routes are served by the Hubfly space Dashboard API and use Dashboard project authorization.

Open interactive API explorer
MethodPathPurpose
GET/api/v1/managed/catalogRead the managed services catalog
GET/api/v1/managed/client-ipRead your public IP address
GET/api/v1/pricing/managed/estimateEstimate a managed instance price
GET/api/v1/pricing/managedRead managed services rates
GET/api/v1/projects/:projectId/managedRead the managed project overview
GETRead the managed services catalogDetails +/api/v1/managed/catalog

Returns the managed services, database engines with their available versions and starting prices, size presets and limits, the allowlist and per-account instance limits, and realtime server settings. available is false when Hubfly space is not accepting new database instances.

  • Requires a signed-in user or personal access token; no project permission is checked.
  • Platform and sub-account keys are refused with 403 MACHINE_CREDENTIAL_UNSUPPORTED.
  • Deprecated engine versions are left out of the list.
Responses
  • 200 — Successful response
    Response schema
    {
      "type": "object",
      "properties": {
        "ok": {
          "const": true,
          "type": "boolean"
        },
        "data": {
          "type": "object",
          "properties": {
            "available": {
              "type": "boolean"
            },
            "services": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "enum": [
                      "database",
                      "cache",
                      "realtime",
                      "stream"
                    ]
                  },
                  "label": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "available",
                      "coming_soon"
                    ]
                  }
                },
                "required": [
                  "id",
                  "label",
                  "description",
                  "status"
                ],
                "additionalProperties": false
              }
            },
            "engines": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "enum": [
                      "postgresql",
                      "mysql",
                      "libsql"
                    ]
                  },
                  "label": {
                    "type": "string"
                  },
                  "shortLabel": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "minMemoryMib": {
                    "type": "number"
                  },
                  "transport": {
                    "type": "string",
                    "enum": [
                      "tcp",
                      "https"
                    ]
                  },
                  "exportFormats": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "native",
                        "sql"
                      ]
                    }
                  },
                  "capabilities": {
                    "type": "object",
                    "properties": {
                      "databases": {
                        "type": "boolean"
                      },
                      "users": {
                        "type": "boolean"
                      },
                      "tokens": {
                        "type": "boolean"
                      },
                      "query": {
                        "type": "boolean"
                      },
                      "schema": {
                        "type": "boolean"
                      },
                      "explorer": {
                        "type": "boolean"
                      },
                      "config": {
                        "type": "boolean"
                      },
                      "rawConfig": {
                        "type": "boolean"
                      },
                      "certificate": {
                        "type": "boolean"
                      },
                      "extensions": {
                        "type": "boolean"
                      },
                      "insights": {
                        "type": "boolean"
                      },
                      "sessions": {
                        "type": "boolean"
                      },
                      "shell": {
                        "type": "boolean"
                      },
                      "export": {
                        "type": "boolean"
                      },
                      "import": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "databases",
                      "users",
                      "tokens",
                      "query",
                      "schema",
                      "explorer",
                      "config",
                      "rawConfig",
                      "certificate",
                      "extensions",
                      "insights",
                      "sessions",
                      "shell",
                      "export",
                      "import"
                    ],
                    "additionalProperties": false
                  },
                  "versions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        },
                        "isDefault": {
                          "type": "boolean"
                        },
                        "lts": {
                          "type": "boolean"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "available",
                            "preview",
                            "deprecated"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "isDefault",
                        "lts",
                        "status"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "startingPrice": {
                    "type": "object",
                    "properties": {
                      "currency": {
                        "const": "USD",
                        "type": "string"
                      },
                      "hoursPerMonth": {
                        "type": "number"
                      },
                      "hourly": {
                        "type": "object",
                        "properties": {
                          "compute": {
                            "type": "number"
                          },
                          "storage": {
                            "type": "number"
                          },
                          "management": {
                            "type": "number"
                          },
                          "total": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "compute",
                          "storage",
                          "management",
                          "total"
                        ],
                        "additionalProperties": false
                      },
                      "monthly": {
                        "type": "object",
                        "properties": {
                          "compute": {
                            "type": "number"
                          },
                          "storage": {
                            "type": "number"
                          },
                          "management": {
                            "type": "number"
                          },
                          "total": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "compute",
                          "storage",
                          "management",
                          "total"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "currency",
                      "hoursPerMonth",
                      "hourly",
                      "monthly"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "id",
                  "label",
                  "shortLabel",
                  "description",
                  "minMemoryMib",
                  "transport",
                  "exportFormats",
                  "capabilities",
                  "versions",
                  "startingPrice"
                ],
                "additionalProperties": false
              }
            },
            "sizes": {
              "type": "object",
              "properties": {
                "presets": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string"
                      },
                      "cpu": {
                        "type": "number"
                      },
                      "memoryMib": {
                        "type": "number"
                      },
                      "description": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "label",
                      "cpu",
                      "memoryMib",
                      "description"
                    ],
                    "additionalProperties": false
                  }
                },
                "cpu": {
                  "type": "object",
                  "properties": {
                    "min": {
                      "type": "number"
                    },
                    "max": {
                      "type": "number"
                    },
                    "step": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "min",
                    "max",
                    "step"
                  ],
                  "additionalProperties": false
                },
                "memoryMib": {
                  "type": "object",
                  "properties": {
                    "min": {
                      "type": "number"
                    },
                    "max": {
                      "type": "number"
                    },
                    "step": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "min",
                    "max",
                    "step"
                  ],
                  "additionalProperties": false
                },
                "storageGib": {
                  "type": "object",
                  "properties": {
                    "min": {
                      "type": "number"
                    },
                    "max": {
                      "type": "number"
                    },
                    "default": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "min",
                    "max",
                    "default"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "presets",
                "cpu",
                "memoryMib",
                "storageGib"
              ],
              "additionalProperties": false
            },
            "maxAllowlistEntries": {
              "type": "number"
            },
            "maxInstancesPerAccount": {
              "type": "number"
            },
            "realtime": {
              "type": "object",
              "properties": {
                "available": {
                  "type": "boolean"
                },
                "engine": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "const": "realtime",
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "shortLabel": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "minMemoryMib": {
                      "type": "number"
                    },
                    "versions": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "isDefault": {
                            "type": "boolean"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "available",
                              "preview",
                              "deprecated"
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "isDefault",
                          "status"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "id",
                    "label",
                    "shortLabel",
                    "description",
                    "minMemoryMib",
                    "versions"
                  ],
                  "additionalProperties": false
                },
                "sizes": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string"
                      },
                      "cpu": {
                        "type": "number"
                      },
                      "memoryMib": {
                        "type": "number"
                      },
                      "description": {
                        "type": "string"
                      },
                      "profile": {
                        "type": "object",
                        "properties": {
                          "memoryMib": {
                            "type": "number"
                          },
                          "cpu": {
                            "type": "number"
                          },
                          "maxConnections": {
                            "type": "number"
                          },
                          "deliveriesPerSecond": {
                            "type": "number"
                          },
                          "publishesPerSecond": {
                            "type": "number"
                          },
                          "maxPayloadBytes": {
                            "type": "number"
                          },
                          "bandwidthMbps": {
                            "type": "number"
                          },
                          "historyMaxTtlSeconds": {
                            "type": "number"
                          },
                          "memoryLimitBytes": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "memoryMib",
                          "cpu",
                          "maxConnections",
                          "deliveriesPerSecond",
                          "publishesPerSecond",
                          "maxPayloadBytes",
                          "bandwidthMbps",
                          "historyMaxTtlSeconds",
                          "memoryLimitBytes"
                        ],
                        "additionalProperties": false
                      },
                      "price": {
                        "type": "object",
                        "properties": {
                          "currency": {
                            "const": "USD",
                            "type": "string"
                          },
                          "hoursPerMonth": {
                            "type": "number"
                          },
                          "hourly": {
                            "type": "object",
                            "properties": {
                              "compute": {
                                "type": "number"
                              },
                              "storage": {
                                "type": "number"
                              },
                              "management": {
                                "type": "number"
                              },
                              "total": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "compute",
                              "storage",
                              "management",
                              "total"
                            ],
                            "additionalProperties": false
                          },
                          "monthly": {
                            "type": "object",
                            "properties": {
                              "compute": {
                                "type": "number"
                              },
                              "storage": {
                                "type": "number"
                              },
                              "management": {
                                "type": "number"
                              },
                              "total": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "compute",
                              "storage",
                              "management",
                              "total"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "currency",
                          "hoursPerMonth",
                          "hourly",
                          "monthly"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "id",
                      "label",
                      "cpu",
                      "memoryMib",
                      "description",
                      "profile",
                      "price"
                    ],
                    "additionalProperties": false
                  }
                },
                "storageGib": {
                  "type": "object",
                  "properties": {
                    "min": {
                      "type": "number"
                    },
                    "max": {
                      "type": "number"
                    },
                    "default": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "min",
                    "max",
                    "default"
                  ],
                  "additionalProperties": false
                },
                "startingPrice": {
                  "type": "object",
                  "properties": {
                    "currency": {
                      "const": "USD",
                      "type": "string"
                    },
                    "hoursPerMonth": {
                      "type": "number"
                    },
                    "hourly": {
                      "type": "object",
                      "properties": {
                        "compute": {
                          "type": "number"
                        },
                        "storage": {
                          "type": "number"
                        },
                        "management": {
                          "type": "number"
                        },
                        "total": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "compute",
                        "storage",
                        "management",
                        "total"
                      ],
                      "additionalProperties": false
                    },
                    "monthly": {
                      "type": "object",
                      "properties": {
                        "compute": {
                          "type": "number"
                        },
                        "storage": {
                          "type": "number"
                        },
                        "management": {
                          "type": "number"
                        },
                        "total": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "compute",
                        "storage",
                        "management",
                        "total"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "currency",
                    "hoursPerMonth",
                    "hourly",
                    "monthly"
                  ],
                  "additionalProperties": false
                },
                "limits": {
                  "type": "object",
                  "properties": {
                    "maxAppsPerInstance": {
                      "type": "number"
                    },
                    "maxKeysPerApp": {
                      "type": "number"
                    },
                    "maxWebhooksPerApp": {
                      "type": "number"
                    },
                    "maxAllowedOrigins": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "maxAppsPerInstance",
                    "maxKeysPerApp",
                    "maxWebhooksPerApp",
                    "maxAllowedOrigins"
                  ],
                  "additionalProperties": false
                },
                "webhookEvents": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "keyGraceSeconds": {
                  "type": "number"
                },
                "maxInstancesPerAccount": {
                  "type": "number"
                }
              },
              "required": [
                "available",
                "engine",
                "sizes",
                "storageGib",
                "startingPrice",
                "limits",
                "webhookEvents",
                "keyGraceSeconds",
                "maxInstancesPerAccount"
              ],
              "additionalProperties": false
            },
            "streams": {
              "type": "object",
              "properties": {
                "available": {
                  "type": "boolean"
                },
                "speedPresetsMbps": {
                  "type": "array",
                  "items": {
                    "type": "number"
                  }
                },
                "speedMbps": {
                  "type": "object",
                  "properties": {
                    "min": {
                      "type": "number"
                    },
                    "max": {
                      "type": "number"
                    },
                    "step": {
                      "type": "number"
                    },
                    "default": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "min",
                    "max",
                    "step",
                    "default"
                  ],
                  "additionalProperties": false
                },
                "processingMbps": {
                  "type": "object",
                  "properties": {
                    "min": {
                      "type": "number"
                    },
                    "max": {
                      "type": "number"
                    },
                    "default": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "min",
                    "max",
                    "default"
                  ],
                  "additionalProperties": false
                },
                "maxSpeedMbpsWithoutDeposit": {
                  "type": "number"
                },
                "freeSpeedMbps": {
                  "type": "number"
                },
                "maxInstancesPerAccount": {
                  "type": "number"
                },
                "startingPrice": {
                  "type": "object",
                  "properties": {
                    "hourly": {
                      "type": "object",
                      "properties": {
                        "speedMicroUsd": {
                          "type": "number"
                        },
                        "speedMicroUsdAfterFree": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "speedMicroUsd",
                        "speedMicroUsdAfterFree"
                      ],
                      "additionalProperties": false
                    },
                    "monthly": {
                      "type": "object",
                      "properties": {
                        "speedUsd": {
                          "type": "number"
                        },
                        "speedUsdAfterFree": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "speedUsd",
                        "speedUsdAfterFree"
                      ],
                      "additionalProperties": false
                    },
                    "freeSpeedMbps": {
                      "type": "number"
                    },
                    "pricing": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "number"
                        },
                        "speedMicroUsdPerMbpsHour": {
                          "type": "number"
                        },
                        "processingMicroUsdPerMbpsHour": {
                          "type": "number"
                        },
                        "bandwidthMicroUsdPerGb": {
                          "type": "number"
                        },
                        "freeSpeedMbpsPerHour": {
                          "type": "number"
                        },
                        "freeProcessingMbpsHoursPerMonth": {
                          "type": "number"
                        },
                        "freeBandwidthGbPerMonth": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "version",
                        "speedMicroUsdPerMbpsHour",
                        "processingMicroUsdPerMbpsHour",
                        "bandwidthMicroUsdPerGb",
                        "freeSpeedMbpsPerHour",
                        "freeProcessingMbpsHoursPerMonth",
                        "freeBandwidthGbPerMonth"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "hourly",
                    "monthly",
                    "freeSpeedMbps",
                    "pricing"
                  ],
                  "additionalProperties": false
                },
                "pricing": {
                  "type": "object",
                  "properties": {
                    "version": {
                      "type": "number"
                    },
                    "speedMicroUsdPerMbpsHour": {
                      "type": "number"
                    },
                    "processingMicroUsdPerMbpsHour": {
                      "type": "number"
                    },
                    "bandwidthMicroUsdPerGb": {
                      "type": "number"
                    },
                    "freeSpeedMbpsPerHour": {
                      "type": "number"
                    },
                    "freeProcessingMbpsHoursPerMonth": {
                      "type": "number"
                    },
                    "freeBandwidthGbPerMonth": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "version",
                    "speedMicroUsdPerMbpsHour",
                    "processingMicroUsdPerMbpsHour",
                    "bandwidthMicroUsdPerGb",
                    "freeSpeedMbpsPerHour",
                    "freeProcessingMbpsHoursPerMonth",
                    "freeBandwidthGbPerMonth"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "available",
                "speedPresetsMbps",
                "speedMbps",
                "processingMbps",
                "maxSpeedMbpsWithoutDeposit",
                "freeSpeedMbps",
                "maxInstancesPerAccount",
                "startingPrice",
                "pricing"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "available",
            "services",
            "engines",
            "sizes",
            "maxAllowlistEntries",
            "maxInstancesPerAccount",
            "realtime",
            "streams"
          ],
          "additionalProperties": false
        },
        "meta": {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string"
            },
            "timestamp": {
              "type": "string"
            }
          },
          "required": [
            "requestId",
            "timestamp"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "ok",
        "data",
        "meta"
      ],
      "additionalProperties": false
    }
    Example response
    {
      "ok": true,
      "data": {
        "available": true,
        "services": [
          {
            "id": "database",
            "label": "string",
            "description": "string",
            "status": "available"
          }
        ],
        "engines": [
          {
            "id": "postgresql",
            "label": "string",
            "shortLabel": "string",
            "description": "string",
            "minMemoryMib": 0,
            "transport": "tcp",
            "exportFormats": [
              "native"
            ],
            "capabilities": {
              "databases": true,
              "users": true,
              "tokens": true,
              "query": true,
              "schema": true,
              "explorer": true,
              "config": true,
              "rawConfig": true,
              "certificate": true,
              "extensions": true,
              "insights": true,
              "sessions": true,
              "shell": true,
              "export": true,
              "import": true
            },
            "versions": [
              {
                "id": "string",
                "label": "string",
                "isDefault": true,
                "lts": true,
                "status": "available"
              }
            ],
            "startingPrice": {
              "currency": "string",
              "hoursPerMonth": 0,
              "hourly": {
                "compute": 0,
                "storage": 0,
                "management": 0,
                "total": 0
              },
              "monthly": {
                "compute": 0,
                "storage": 0,
                "management": 0,
                "total": 0
              }
            }
          }
        ],
        "sizes": {
          "presets": [
            {
              "id": "string",
              "label": "string",
              "cpu": 0,
              "memoryMib": 0,
              "description": "string"
            }
          ],
          "cpu": {
            "min": 0,
            "max": 0,
            "step": 0
          },
          "memoryMib": {
            "min": 0,
            "max": 0,
            "step": 0
          },
          "storageGib": {
            "min": 0,
            "max": 0,
            "default": 0
          }
        },
        "maxAllowlistEntries": 0,
        "maxInstancesPerAccount": 0,
        "realtime": {
          "available": true,
          "engine": {
            "id": "string",
            "label": "string",
            "shortLabel": "string",
            "description": "string",
            "minMemoryMib": 0,
            "versions": [
              {
                "id": "string",
                "label": "string",
                "isDefault": true,
                "status": "available"
              }
            ]
          },
          "sizes": [
            {
              "id": "string",
              "label": "string",
              "cpu": 0,
              "memoryMib": 0,
              "description": "string",
              "profile": {
                "memoryMib": 0,
                "cpu": 0,
                "maxConnections": 0,
                "deliveriesPerSecond": 0,
                "publishesPerSecond": 0,
                "maxPayloadBytes": 0,
                "bandwidthMbps": 0,
                "historyMaxTtlSeconds": 0,
                "memoryLimitBytes": 0
              },
              "price": {
                "currency": "string",
                "hoursPerMonth": 0,
                "hourly": {
                  "compute": 0,
                  "storage": 0,
                  "management": 0,
                  "total": 0
                },
                "monthly": {
                  "compute": 0,
                  "storage": 0,
                  "management": 0,
                  "total": 0
                }
              }
            }
          ],
          "storageGib": {
            "min": 0,
            "max": 0,
            "default": 0
          },
          "startingPrice": {
            "currency": "string",
            "hoursPerMonth": 0,
            "hourly": {
              "compute": 0,
              "storage": 0,
              "management": 0,
              "total": 0
            },
            "monthly": {
              "compute": 0,
              "storage": 0,
              "management": 0,
              "total": 0
            }
          },
          "limits": {
            "maxAppsPerInstance": 0,
            "maxKeysPerApp": 0,
            "maxWebhooksPerApp": 0,
            "maxAllowedOrigins": 0
          },
          "webhookEvents": [
            "string"
          ],
          "keyGraceSeconds": 0,
          "maxInstancesPerAccount": 0
        },
        "streams": {
          "available": true,
          "speedPresetsMbps": [
            0
          ],
          "speedMbps": {
            "min": 0,
            "max": 0,
            "step": 0,
            "default": 0
          },
          "processingMbps": {
            "min": 0,
            "max": 0,
            "default": 0
          },
          "maxSpeedMbpsWithoutDeposit": 0,
          "freeSpeedMbps": 0,
          "maxInstancesPerAccount": 0,
          "startingPrice": {
            "hourly": {
              "speedMicroUsd": 0,
              "speedMicroUsdAfterFree": 0
            },
            "monthly": {
              "speedUsd": 0,
              "speedUsdAfterFree": 0
            },
            "freeSpeedMbps": 0,
            "pricing": {
              "version": 0,
              "speedMicroUsdPerMbpsHour": 0,
              "processingMicroUsdPerMbpsHour": 0,
              "bandwidthMicroUsdPerGb": 0,
              "freeSpeedMbpsPerHour": 0,
              "freeProcessingMbpsHoursPerMonth": 0,
              "freeBandwidthGbPerMonth": 0
            }
          },
          "pricing": {
            "version": 0,
            "speedMicroUsdPerMbpsHour": 0,
            "processingMicroUsdPerMbpsHour": 0,
            "bandwidthMicroUsdPerGb": 0,
            "freeSpeedMbpsPerHour": 0,
            "freeProcessingMbpsHoursPerMonth": 0,
            "freeBandwidthGbPerMonth": 0
          }
        }
      },
      "meta": {
        "requestId": "string",
        "timestamp": "string"
      }
    }
GETRead your public IP addressDetails +/api/v1/managed/client-ip

Returns the IP address Hubfly space sees for the current request and its family (4 or 6), so you can add it to an instance allowlist. Both fields are null when the address cannot be determined.

  • Requires a signed-in user or personal access token.
  • Platform and sub-account keys are refused with 403 MACHINE_CREDENTIAL_UNSUPPORTED.
Responses
  • 200 — Successful response
    Response schema
    {
      "type": "object",
      "properties": {
        "ok": {
          "const": true,
          "type": "boolean"
        },
        "data": {
          "type": "object",
          "properties": {
            "ip": {
              "type": "string",
              "nullable": true
            },
            "family": {
              "oneOf": [
                {
                  "const": 4,
                  "type": "number"
                },
                {
                  "const": 6,
                  "type": "number"
                }
              ],
              "nullable": true
            }
          },
          "required": [
            "ip",
            "family"
          ],
          "additionalProperties": false
        },
        "meta": {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string"
            },
            "timestamp": {
              "type": "string"
            }
          },
          "required": [
            "requestId",
            "timestamp"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "ok",
        "data",
        "meta"
      ],
      "additionalProperties": false
    }
    Example response
    {
      "ok": true,
      "data": {
        "ip": "string",
        "family": null
      },
      "meta": {
        "requestId": "string",
        "timestamp": "string"
      }
    }
GETEstimate a managed instance priceDetails +/api/v1/pricing/managed/estimate

Returns the hourly and monthly price of a running managed instance of the given size, split into compute, storage and management fee, in USD.

  • No authentication required. Calls made with a platform or sub-account key are refused with 403 MACHINE_CREDENTIAL_UNSUPPORTED.
  • cpu must be 0.25-8, memoryMib 256-32768 and storageGib 1-500; otherwise 400 MANAGED_INVALID_SIZE.
  • Use the returned hourly.total as quotedHourlyTotal when you create or resize an instance.
Request parameters
NameLocationRequiredTypeDescription
cpuqueryYesnumber—
memoryMibqueryYesnumber—
storageGibqueryYesnumber—
Responses
  • 200 — Successful response
    Response schema
    {
      "type": "object",
      "properties": {
        "ok": {
          "const": true,
          "type": "boolean"
        },
        "data": {
          "type": "object",
          "properties": {
            "currency": {
              "const": "USD",
              "type": "string"
            },
            "hoursPerMonth": {
              "type": "number"
            },
            "hourly": {
              "type": "object",
              "properties": {
                "compute": {
                  "type": "number"
                },
                "storage": {
                  "type": "number"
                },
                "management": {
                  "type": "number"
                },
                "total": {
                  "type": "number"
                }
              },
              "required": [
                "compute",
                "storage",
                "management",
                "total"
              ],
              "additionalProperties": false
            },
            "monthly": {
              "type": "object",
              "properties": {
                "compute": {
                  "type": "number"
                },
                "storage": {
                  "type": "number"
                },
                "management": {
                  "type": "number"
                },
                "total": {
                  "type": "number"
                }
              },
              "required": [
                "compute",
                "storage",
                "management",
                "total"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "currency",
            "hoursPerMonth",
            "hourly",
            "monthly"
          ],
          "additionalProperties": false
        },
        "meta": {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string"
            },
            "timestamp": {
              "type": "string"
            }
          },
          "required": [
            "requestId",
            "timestamp"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "ok",
        "data",
        "meta"
      ],
      "additionalProperties": false
    }
    Example response
    {
      "ok": true,
      "data": {
        "currency": "string",
        "hoursPerMonth": 0,
        "hourly": {
          "compute": 0,
          "storage": 0,
          "management": 0,
          "total": 0
        },
        "monthly": {
          "compute": 0,
          "storage": 0,
          "management": 0,
          "total": 0
        }
      },
      "meta": {
        "requestId": "string",
        "timestamp": "string"
      }
    }
GETRead managed services ratesDetails +/api/v1/pricing/managed

Returns the rates used to price managed instances: per-vCPU-hour, per-GiB-hour memory and storage rates, the management fee rate applied to compute, the currency and the hours counted per month.

  • No authentication required. Calls made with a platform or sub-account key are refused with 403 MACHINE_CREDENTIAL_UNSUPPORTED.
Responses
  • 200 — Successful response
    Response schema
    {
      "type": "object",
      "properties": {
        "ok": {
          "const": true,
          "type": "boolean"
        },
        "data": {
          "type": "object",
          "properties": {
            "currency": {
              "const": "USD",
              "type": "string"
            },
            "hoursPerMonth": {
              "type": "number"
            },
            "cpuPerVcpuHour": {
              "type": "number"
            },
            "memoryPerGibHour": {
              "type": "number"
            },
            "storagePerGibHour": {
              "type": "number"
            },
            "managementFeeRate": {
              "const": 0.3,
              "type": "number"
            }
          },
          "required": [
            "currency",
            "hoursPerMonth",
            "cpuPerVcpuHour",
            "memoryPerGibHour",
            "storagePerGibHour",
            "managementFeeRate"
          ],
          "additionalProperties": false
        },
        "meta": {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string"
            },
            "timestamp": {
              "type": "string"
            }
          },
          "required": [
            "requestId",
            "timestamp"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "ok",
        "data",
        "meta"
      ],
      "additionalProperties": false
    }
    Example response
    {
      "ok": true,
      "data": {
        "currency": "string",
        "hoursPerMonth": 0,
        "cpuPerVcpuHour": 0,
        "memoryPerGibHour": 0,
        "storagePerGibHour": 0,
        "managementFeeRate": 0
      },
      "meta": {
        "requestId": "string",
        "timestamp": "string"
      }
    }
GETRead the managed project overviewDetails +/api/v1/projects/:projectId/managed

Returns instance counts by state (running, transitioning, stopped, failed), the combined hourly and monthly cost of the project's instances, and the per-account instance limits. Only instances of services you can read are counted.

  • Requires database:read or realtime:read.
  • Works only on a project of type managed; other projects return 409 MANAGED_PROJECT_REQUIRED.
  • Stopped instances are counted at their storage price only.
Request parameters
NameLocationRequiredTypeDescription
projectIdpathYesstring—
Responses
  • 200 — Successful response
    Response schema
    {
      "type": "object",
      "properties": {
        "ok": {
          "const": true,
          "type": "boolean"
        },
        "data": {
          "type": "object",
          "properties": {
            "counts": {
              "type": "object",
              "properties": {
                "total": {
                  "type": "number"
                },
                "running": {
                  "type": "number"
                },
                "transitioning": {
                  "type": "number"
                },
                "stopped": {
                  "type": "number"
                },
                "failed": {
                  "type": "number"
                }
              },
              "required": [
                "total",
                "running",
                "transitioning",
                "stopped",
                "failed"
              ],
              "additionalProperties": false
            },
            "cost": {
              "type": "object",
              "properties": {
                "hourly": {
                  "type": "number"
                },
                "monthly": {
                  "type": "number"
                }
              },
              "required": [
                "hourly",
                "monthly"
              ],
              "additionalProperties": false
            },
            "limits": {
              "type": "object",
              "properties": {
                "maxInstancesPerAccount": {
                  "type": "number"
                },
                "maxRealtimeInstancesPerAccount": {
                  "type": "number"
                },
                "maxStreamInstancesPerAccount": {
                  "type": "number"
                }
              },
              "required": [
                "maxInstancesPerAccount",
                "maxRealtimeInstancesPerAccount",
                "maxStreamInstancesPerAccount"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "counts",
            "cost",
            "limits"
          ],
          "additionalProperties": false
        },
        "meta": {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string"
            },
            "timestamp": {
              "type": "string"
            }
          },
          "required": [
            "requestId",
            "timestamp"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "ok",
        "data",
        "meta"
      ],
      "additionalProperties": false
    }
    Example response
    {
      "ok": true,
      "data": {
        "counts": {
          "total": 0,
          "running": 0,
          "transitioning": 0,
          "stopped": 0,
          "failed": 0
        },
        "cost": {
          "hourly": 0,
          "monthly": 0
        },
        "limits": {
          "maxInstancesPerAccount": 0,
          "maxRealtimeInstancesPerAccount": 0,
          "maxStreamInstancesPerAccount": 0
        }
      },
      "meta": {
        "requestId": "string",
        "timestamp": "string"
      }
    }

Related guides

Something unclear or out of date? Emailsupport@hubfly.spaceBack to top