Skip to main content
GET
/
access-tokens
List access tokens.
curl --request GET \
  --url https://aws.s2.dev/v1/access-tokens \
  --header 'Authorization: Bearer <token>'
{
  "access_tokens": [
    {
      "id": "<string>",
      "scope": {
        "access_tokens": {
          "exact": "<string>"
        },
        "basins": {
          "exact": "<string>"
        },
        "op_groups": {
          "account": {
            "read": false,
            "write": false
          },
          "basin": {
            "read": false,
            "write": false
          },
          "stream": {
            "read": false,
            "write": false
          }
        },
        "ops": [],
        "streams": {
          "exact": "<string>"
        }
      },
      "auto_prefix_streams": false,
      "expires_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true
}

Access token concepts

Review token scopes, permissions, expiry, and revocation behavior.
Model paging by specifying start_after as the last access token ID that was returned.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Query Parameters

​
prefix
string
default:""

Filter to access tokens whose IDs begin with this prefix.

​
start_after
string
default:""

Filter to access tokens whose IDs lexicographically start after this string.

​
limit
integer
default:1000

Number of results, up to a maximum of 1000.

Required range: 0 <= x <= 1000

Response

​
access_tokens
object[]
required

Matching access tokens.

Maximum array length: 1000
​
has_more
boolean
required

Indicates that there are more access tokens that match the criteria.