Sign in

v2

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-027801.5 MB
Quality-of-Service on Demand v1.0.0

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/quality-on-demand/v1/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
sinkstring uri

The address to which events about all status changes of the session (e.g. session termination) shall be delivered using the selected protocol.

sessionIdstring uuid required

Session ID in UUID format

durationinteger required
startedAtstring date-time

Date and time when the QoS status became "AVAILABLE". Not to be returned when qosStatus is "REQUESTED". Format must follow RFC 3339 and must indicate time zone (UTC or local).

expiresAtstring date-time

Date and time of the QoS session expiration. Format must follow RFC 3339 and must indicate time zone (UTC or local).

  • When qosStatus is "AVAILABLE", it is the limit time when the session is scheduled to finnish, if not terminated by other means.
  • When qosStatus is "UNAVAILABLE", it is the time when the session was terminated.
  • Not to be returned when qosStatus is "REQUESTED". When the session is extended, the value is the new expiration time of the session.
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
statusInfo'DURATION_EXPIRED' | 'NETWORK_TERMINATED' | 'DELETE_REQUESTED'

Reason for the new qosStatus. Currently statusInfo is only applicable when qosStatus is 'UNAVAILABLE'.

  • DURATION_EXPIRED - Session terminated due to requested duration expired
  • NETWORK_TERMINATED - Network terminated the session before the requested duration expired
  • DELETE_REQUESTED- User requested the deletion of the session before the requested duration expired