Sign in

v2

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-027801.5 MB
Quality-of-Service on Demand v0.10.1

Extend the duration of an active session

Extend the overall duration of an active QoS session. If this operation is executed successfully, the new duration of the target session will be the original duration plus the additionally requested duration. The new remaining duration of the QoS session shall not exceed the maximum remaining duration limit (currently fixed at 86,400 seconds) where the remaining duration is calculated as the difference between the expiresAt and current time when the request to extend the session duration is received. If this maximum limit would be exceeded, the overall duration shall be set such that the remaining duration is equal to this limit. An example: A QoD session was originally created with duration 80,000 seconds. 10,000 seconds later, the developer requested to extend the session by 20,000 seconds.

  • Original duration: 80,000 seconds
  • Elapsed time: 10,000 seconds
  • Remaining duration: 70,000 seconds
  • New remaining duration: 86,400 seconds (the maximum allowed)
  • New overall session duration: 96,400 seconds
post/qod/v0/sessions/{sessionId}/extend

Path parameters

sessionIdstring uuid required

Session ID in UUID format

Session ID that was obtained from the createSession operation

Headers

x-rapidapi-hoststring required
Example:network-as-code.p-eu.rapidapi.com

The API's Host value as defined in the RapidAPI Hub.

Request body

requestedAdditionalDurationinteger required

Additional duration in seconds to be extended.

Response

qosProfilestring string required

A unique name for identifying a specific QoS profile. This may follow different formats depending on the service providers implementation. Some options addresses:

  • A UUID style string
  • Support for predefined profiles QOS_S, QOS_M, QOS_L, and QOS_E
  • A searchable descriptive name
sessionIdstring uuid required

Session ID in UUID format

durationinteger required
startedAtinteger required

Timestamp of session start in seconds since Unix epoch

expiresAtinteger required

Timestamp of session expiration if the session was not deleted, in seconds since Unix epoch

qosStatus'REQUESTED' | 'AVAILABLE' | 'UNAVAILABLE' required

The current status of the requested QoS session. The status can be one of the following:

  • REQUESTED - QoS has been requested by creating a session
  • AVAILABLE - The requested QoS has been provided by the network
  • UNAVAILABLE - The requested QoS cannot be provided by the network due to some reason