Help Center/ KooDrive/ API Reference（Carrier）/ API/ Login and logout/ Refresh Token
Updated on 2026-04-16 GMT+08:00
View PDF
Share

Refresh Token

Function

Refresh token.

URI

POST /koodrive/ose/v1/auth/refreshToken

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

Authorization

Yes

String

Definition:

Access token. Token authentication is used to call KooDrive APIs. A token indicates the permission. When an API is called, the token is added to the request header to obtain the operation permission. Format: AT+{access_token}

Constraints:

N/A

Range:

N/A

Default Value:

N/A

X-Traceid

No

String

Definition:

Service trace ID, which contains 58 bits.

Constraints:

N/A

Range:

The value contains 58 bits.

Default Value:

N/A
Table 2 Request body parameters

Parameter

Mandatory

Type

Description

refreshToken

Yes

String

RT

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

code

String

Error Codes

msg

String

Error description.

data

SessionInfo object

Authentication information.
Table 4 SessionInfo

Parameter

Type

Description

accessToken

String

Access token.

expiresIn

Long

Validity period.

issuedAt

String

Generation time.

refreshToken

String

Refresh token.

Example Requests

POST /koodrive/ose/v1/auth/refreshToken

{
  "refreshToken" : "0e0e72d3c7e9e4444df6bc3fb111eaee18eb7b2393a939cb"
}

Example Responses

Status code: 200

Response to the request for a refresh token.

{
  "data" : {
    "sessionInfo" : {
      "accessToken" : "AT 3b911d723003f70a1265124148fdfe486c108b64bf8d0de3",
      "expiresIn" : 1800,
      "issuedAt" : "1772006999088",
      "refreshToken" : "0e0e72d3c7e9e4444df6bc3fb111eaee18eb7b2393a939cb"
    }
  },
  "code" : 0,
  "msg" : "Success"
}

Status Codes

Status Code

Description

200

Response to the request for a refresh token.
Parent topic: Login and logout