ovahub
Skip to documentation
DocumentationAPI referenceCheck private network attachment
GETBearer token

Check private network attachment

/api/v1/networks/:id/attach-check

Compare local region and provider data for an owned network and a current, non-deleted organization server. Missing or unowned resources return 404. This check never authorizes attachment.

Before you call

Read-only local data. No supplier requests, billing or writes are performed. All capabilities are false; matching regions or providers does not prove compatibility or safe attachment.

Request example

cURL
curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/attach-check?serverId=507f1f77bcf86cd799439013" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "networkId": "507f1f77bcf86cd799439011",
  "serverId": "507f1f77bcf86cd799439013",
  "source": "local",
  "regionMatch": true,
  "providerMatch": true,
  "eligible": false,
  "requiresRestart": "unknown",
  "requiresReinstall": "unknown",
  "ipChange": "unknown",
  "addon": {
    "state": "unknown",
    "checkedAt": null,
    "cancelEffectiveAt": null,
    "verification": "unknown"
  },
  "testOnly": true,
  "capabilities": {
    "purchase": false,
    "attach": false,
    "disconnect": false,
    "remove": false,
    "reconnect": false,
    "cancelAddon": false,
    "renew": false,
    "resize": false,
    "delete": false,
    "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
  },
  "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
}

Parameters

idPath · Required

string

Resource ID: 24 hexadecimal characters. Use the platform ID returned by the matching list endpoint, not a supplier instance ID.

serverIdQuery · Required

string

Current organization server ID: 24 hexadecimal characters. Deleted or transferred servers are not accessible.

Response

HTTP status 200

Compare local region and provider data for an owned network and a current, non-deleted organization server. Missing or unowned resources return 404. This check never authorizes attachment.

networkIdstring

Platform identifier, not a supplier identifier.

serverIdstring

Platform identifier, not a supplier identifier.

source"local"

Always local; no live supplier request is made.

regionMatchboolean

Local comparison only; true does not establish compatibility or safe attachment.

providerMatchboolean

Local comparison only; true does not establish compatibility or safe attachment.

eligiblefalse

Read-only local data. No supplier requests, billing or writes are performed. All capabilities are false; matching regions or providers does not prove compatibility or safe attachment.

requiresRestart"unknown"

Always unknown; restart, reinstall and IP-change effects have not been verified.

requiresReinstall"unknown"

Always unknown; restart, reinstall and IP-change effects have not been verified.

ipChange"unknown"

Always unknown; restart, reinstall and IP-change effects have not been verified.

addonobject

Local addon snapshot after checking server ownership. Without valid checkedAt: state unknown, both timestamps null and verification unknown. A checked snapshot has verification snapshot; cancel_pending does not prove cancellation or exemption from the next charge.

addon.statestring

Local addon snapshot after checking server ownership. Without valid checkedAt: state unknown, both timestamps null and verification unknown. A checked snapshot has verification snapshot; cancel_pending does not prove cancellation or exemption from the next charge.

addon.checkedAtstring | null

Snapshot check time in ISO 8601, or null when unknown. A timestamp is not a live verification.

addon.cancelEffectiveAtstring | null

Local addon snapshot after checking server ownership. Without valid checkedAt: state unknown, both timestamps null and verification unknown. A checked snapshot has verification snapshot; cancel_pending does not prove cancellation or exemption from the next charge.

addon.verification"unknown" | "snapshot"

Local addon snapshot after checking server ownership. Without valid checkedAt: state unknown, both timestamps null and verification unknown. A checked snapshot has verification snapshot; cancel_pending does not prove cancellation or exemption from the next charge.

testOnlyboolean

True marks a test context only, which can include real purchased servers. It does not prove simulation or bypass billing or safety checks.

capabilitiesobject

All nine flags are false: purchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize and delete. blockedReason explains that supplier support is unverified and billing is unavailable until verified; snapshots do not establish compatibility or safe attachment.

blockedReasonstring

Read-only local data. No supplier requests, billing or writes are performed. All capabilities are false; matching regions or providers does not prove compatibility or safe attachment.

Related

Requests & errorsAuthenticationMCP · check_network_attach