List access tokens

get

https://{hostname}/edgekv/v1/tokens

View a list of EdgeKV access tokens.

Responses

Response body

object

tokens

array of objects

required

length ≥ 1

A list of tokens.

tokens*

object

expiry

date

Tokens created using the enhanced token workflow have an expiry date, in ISO 8601 format, of 9999-12-31. Any tokens created before the release of the enhanced workflow display an actual expiry date such as 2025-02-28.

issueDate

date

Initial token creation date in ISO 8601 format.

latestRefreshDate

date | null

Most recent token refresh date in ISO 8601 format. A null value indicates the token has not yet been refreshed.

name

string

length between 1 and 32

Friendly name of the token. Used when retrieving tokens by name.

nextScheduledRefreshDate

date

Next scheduled date of the token refresh in ISO 8601 format.

tokenActivationStatus

string

enum

The IN_PROGRESS status indicates token activation is still in progress, and it's not yet possible to make successful EdgeKV requests from EdgeWorkers that use the token. Once activation completes, status is COMPLETE. Otherwise a value of ERROR indicates a problem that prevented activation.

IN_PROGRESS COMPLETE ERROR

uuid

A generated unique identifier for the access token. This should be used in the edgekv_tokens.js file.

Language

Authentication

Remember to add your authentication credentials to run this code.

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://hostname/edgekv/v1/tokens \
3
     --header 'accept: application/json'


xxxxxxxxxx
22
 
1
{
2
  "tokens": [
3
    {
4
      "expiry": "9999-12-31",
5
      "issueDate": "2022-01-30",
6
      "latestRefreshDate": "2022-03-30",
7
      "name": "token1",
8
      "nextScheduledRefreshDate": "2022-05-30",
9
      "tokenActivationStatus": "COMPLETE",
10
      "uuid": "12886ccf-xxxx-xxxx-xxxx-766740ce227e"
11
    },
12
    {
13
      "expiry": "9999-12-31",
14
      "issueDate": "2022-04-30",
15
      "latestRefreshDate": null,
16
      "name": "token2",
17
      "nextScheduledRefreshDate": "2022-06-30",
18
      "tokenActivationStatus": "IN_PROGRESS",
19
      "uuid": "12886ccf-xxxx-xxxx-xxxx-766740ce227f"
20
    }
21
  ]
22
}

200Returns a list of EdgeKV access tokens you have permissions to see.

404Not found. No tokens are found.

500Internal server error.