{"uid":"cap_lc79QeKgrxLL6uwpA-lIf","slug":"tempvpn-fixed-duration-session-purchase-86d8317e","name":"TempVPN Fixed-Duration Session Purchase","description":"Fixed sessions cost $0.01 per minute. Duration is expressed in seconds and must be a positive multiple of 60: $0.01 × (duration_seconds / 60). The runtime MPP 402 Challenge is authoritative for payment details. After payment, the new session is paused with null client_public_key and assigned_ip.","url":"https://registry.tempvpn.xyz/sessions","method":"POST","headers":{},"bodySchema":{"type":"object","required":["node_id","duration_seconds"],"properties":{"node_id":{"type":"string","minLength":1,"description":"ID of the selected node returned by GET /nodes."},"duration_seconds":{"type":"integer","format":"uint64","maximum":3600,"minimum":60,"examples":[300],"multipleOf":60,"description":"Duration in seconds as a positive multiple of 60, up to 3600 seconds. Fixed access costs $0.01 per minute."}},"additionalProperties":false},"responseSchema":{"type":"object","required":["session_id","node_id","node_url","client_public_key","assigned_ip","created_at","connected_at","last_heartbeat_at","not_after","total_seconds","remaining_seconds","state"],"properties":{"phase":{"type":["string","null"]},"state":{"enum":["paused","active","expired"],"type":"string"},"node_id":{"type":"string","description":"Last selected logical node. A paused capability may connect through another available node_id."},"endpoint":{"type":["string","null"],"description":"WireGuard host:port endpoint, populated after an active connection is established."},"node_url":{"type":"string","format":"uri","description":"Last selected node metadata; the registry remains the lifecycle origin."},"not_after":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"session_id":{"type":"string","pattern":"^sess_[A-Za-z0-9]+$"},"assigned_ip":{"type":["string","null"]},"connected_at":{"type":["string","null"],"format":"date-time"},"total_seconds":{"type":"integer","format":"uint64","minimum":1},"expected_exit_ip":{"type":["string","null"],"description":"Expected public exit IP for the active node."},"client_public_key":{"type":["string","null"]},"last_heartbeat_at":{"type":["string","null"],"format":"date-time"},"remaining_seconds":{"type":"integer","format":"uint64","minimum":0},"server_public_key":{"type":["string","null"],"description":"WireGuard server public key, populated after an active connection is established."}}},"example":null,"exampleRequest":null,"tags":["networking","privacy","tempo","vpn","wireguard","web"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":true,"priceHint":"$0.01 per minute; duration must be a whole number of minutes.","priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$0.01 per minute; duration must be a whole number of minutes. (dynamic)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fCBBXPoAeRolwYq89cUAE","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"TempVPN","brandSlug":"tempvpn-mpp","brandBaseUrl":"https://registry.tempvpn.xyz","brandDocsUrl":"https://registry.tempvpn.xyz/docs","whatItDoes":"Creates and purchases a fixed-duration WireGuard VPN session on a selected node, billed at $0.01 per minute via Tempo MPP payment.","exampleAgentPrompt":"Buy me a TempVPN session on node 'node_abc123' for 30 minutes so I can browse privately.","exampleUseCases":[{"title":"Quick anonymous browsing session","prompt":"Get me a 10-minute TempVPN session on node 'node_us_east_01' — I just need a quick private connection."},{"title":"Hour-long secure remote access","prompt":"Purchase a 60-minute WireGuard VPN session on TempVPN using node 'node_eu_west_42' so I can work securely from this café."},{"title":"Automated privacy for agent workflow","prompt":"Provision a 5-minute TempVPN session on node 'node_ap_south_7' before my agent runs its web scraping task."}],"resultDescription":"Returns a session object with a unique session_id, the selected node_id and node_url, timestamps (created_at, not_after), total_seconds, remaining_seconds, and a state of 'paused' (since client_public_key and assigned_ip are null until the WireGuard handshake is completed). The session becomes active after the client completes the WireGuard key exchange.","failureModes":["Payment not completed or MPP 402 challenge not satisfied — session is not created","node_id does not correspond to an available node from GET /nodes — likely 404 or 422 error","duration_seconds not a multiple of 60, out of range (< 60 or > 3600), or not a positive integer — 400 validation error","Node becomes unavailable between listing and session purchase — possible 503 or conflict error","Insufficient USDC balance to cover session cost — payment failure"],"whenToPreferThis":"Use this endpoint when you need a fixed-cost, time-bounded WireGuard VPN session and want predictable pricing ($0.01/min). Prefer this over the streaming/metered product when you know the session duration upfront and want a flat fee rather than variable per-second billing. Ideal for automated workflows that need a disposable VPN tunnel for a known time window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:44.351Z","isFirstParty":false}