Default off, broker only: renew a still-valid TCP lease

Internal broker only; excluded from public SDK methods. Default off. Refresh every 10 seconds. Recheck enabled route, generation, role credential and current authorizing administrator membership and paid active entitlement. Return the same bound grant with at most 30 seconds of validity; an expired lease never revives and total lifetime cannot exceed one hour. The broker closes a leg before the last valid expiry if renewal fails. Strict JSON, 4096-byte bodies, 2000 requests/minute.

post/v1/internal/gateway/tcp/leases/refresh

Request

  • Base URL: https://api.decionis.com
  • URL: https://api.decionis.com/v1/internal/gateway/tcp/leases/refresh
  • Auth: HTTP bearer

Request body

lease_idstring uuid required
lease_tokenstring required

Sensitive opaque capability; never put in a URL, log, analytics event or ordinary resource view.

phase'waiting' | 'active' required

Response

Private bounded result.

lease_idstring uuid required
lease_tokenstring required

Sensitive opaque capability; never put in a URL, log, analytics event or ordinary resource view.

org_idstring uuid required
route_idstring uuid required
generationinteger required

Non-secret fencing generation. Discard stale reveals and clear displayed credentials when this changes.

tenant_hoststring required
role'connector' | 'client' required
resource_hashstring required

SHA-256 lowercase hex of the canonical saved numeric IP:port resource string, not a customer payload.

expires_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.