Query Api Tokens

Query Api Tokens
Query API Tokens with search filters and pagination

Queries API Tokens in an SSO Realm with search filters and pagination support. Results can be sorted by expiration date, creation date, last used date, or access token TTL.

Request
URI
POST
https://{api_host}/suite-api/api/fleet-management/iam/ssorealms/{ssoRealmId}/api-tokens/query
COPY
Path Parameters
string
ssoRealmId
Required

SSO Realm identifier

Query Parameters
integer
page
Optional
Constraints: default: 0

Page number from which data needs to be displayed (0-based)

integer
pageSize
Optional
Constraints: default: 50

Expected number of entries per page

string
sortBy
Optional

Field name to sort results by

Possible values are : EXPIRATION_DATE, CREATION_DATE, LAST_USED_DATE, ACCESS_TOKEN_TTL,
string
sortOrder
Optional

Sort order for the results

Possible values are : ASCENDING, DESCENDING,
Request Body

API Tokens search parameters

ClientTokenQuery of type(s) application/json
Required 
"{\n  \"searchTerms\" : {\n    \"allOf\" : [ {\n      \"field\" : \"CLIENT_ID\",\n      \"terms\" : [ \"client\" ],\n      \"operator\" : \"LIKE\"\n    }, {\n      \"field\" : \"TOKEN_NAME\",\n      \"terms\" : [ \"Automation\" ],\n      \"operator\" : \"LIKE\"\n    } ],\n    \"anyOf\" : [ ]\n  },\n  \"filters\" : {\n    \"tokenType\" : [ \"API_CLIENT\", \"USER\" ],\n    \"tokenStatus\" : [ \"ACTIVE\", \"EXPIRED\" ]\n  }\n}"
object
filters
Optional

Field values that can be used to filter API client and API token data

object
searchTerms
Optional

Groupings of search conditions to match in API client and API token lists

Authentication
This operation uses the following authentication methods.
Responses
200

List of API Tokens with pagination data

Returns ApiTokens of type(s) application/json 
"{\n  \"pageInfo\" : {\n    \"totalCount\" : 2,\n    \"page\" : 0,\n    \"pageSize\" : 10\n  },\n  \"apiTokens\" : [ {\n    \"id\" : \"167ab548-2b73-4eee-aeac-80752133b0c3\",\n    \"apiClientId\" : \"api-client-id\",\n    \"tokenName\" : \"Automation API Token\",\n    \"tokenDescription\" : \"Used for generic automation purposes\",\n    \"apiTokenTtl\" : 259200,\n    \"accessTokenTtl\" : 480,\n    \"tokenType\" : \"API_CLIENT\",\n    \"tokenLastChars\" : \"VWXYZ\",\n    \"principalName\" : \"api-client-id\",\n    \"creationDate\" : 1748026688158,\n    \"expirationDate\" : 1750526688158,\n    \"lastUsedDate\" : 1748026688158,\n    \"tokenStatus\" : \"ACTIVE\",\n    \"tokenEndpointUrl\" : \"https://host.com/acs/t/CUSTOMER/token\",\n    \"oidcIssuerUrl\" : \"https://host.com/acs/t/CUSTOMER\"\n  }, {\n    \"id\" : \"167ab548-2b73-4eee-aeac-80752133b0c3\",\n    \"apiClientId\" : \"api-client-id\",\n    \"tokenName\" : \"Automation API Token\",\n    \"tokenDescription\" : \"Used for generic automation purposes\",\n    \"apiTokenTtl\" : 259200,\n    \"accessTokenTtl\" : 480,\n    \"tokenType\" : \"API_CLIENT\",\n    \"tokenLastChars\" : \"VWXYZ\",\n    \"principalName\" : \"api-client-id\",\n    \"creationDate\" : 1748026688158,\n    \"expirationDate\" : 1750526688158,\n    \"lastUsedDate\" : 1748026688158,\n    \"tokenStatus\" : \"ACTIVE\",\n    \"tokenEndpointUrl\" : \"https://host.com/acs/t/CUSTOMER/token\",\n    \"oidcIssuerUrl\" : \"https://host.com/acs/t/CUSTOMER\"\n  } ]\n}"
array of object
apiTokens
Required

List of API token in this page

array of object
links
Optional

Collection of links

object
pageInfo
Optional

Represents page information for a paged result


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/suite-api/api/fleet-management/iam/ssorealms/{ssoRealmId}/api-tokens/query
On This Page
Iam Apis Operations
GET
Get Eligible Components
DELETE
Delete Iam Component Auth Source
POST
Create Iam Component Auth Source
POST
Get Iam Component Auth Sources
GET
Get Component Roles
POST
Provision Component Role
PUT
Update Component Role
GET
Get Component Role Summaries
DELETE
Delete Component Role
GET
Get Component Role
POST
Trigger Drift Check
POST
Retry Apply For Role
GET
Get Component Role Definitions
POST
Configure IDP
PUT
Update IDP Configuration
DELETE
Delete IDP Configuration
GET
Get IDP Configuration
GET
Get Scim Sync Client Info
POST
Generate Scim Sync Client
GET
Get Ldap Directories
POST
Lookup Ldap Groups
POST
Execute Ldap Sync
GET
Get Ldap Sync Logs
GET
Get Ldap Sync Log By Id
GET
Get Ldap Sync Profile
PUT
Update Ldap Sync Profile
POST
Lookup Ldap Users
GET
Get VCF Roles Paginated
POST
Create Role
PUT
Update Role Definition
DELETE
Delete Role
GET
Get Role
POST
Validate Saml Metadata
GET
Get Iam Settings
PUT
Update Iam Settings
GET
Get Sso Realm List
POST
Create Sso Realm
DELETE
Delete Sso Realm
GET
Get Sso Realm
PATCH
Update Api Client
POST
Create Api Client
POST
Query Api Clients
DELETE
Delete Api Client
GET
Get Api Client
PATCH
Update Api Token
POST
Generate Api Token
POST
Query Api Tokens
DELETE
Delete Api Token
GET
Get Api Token
POST
Re Generate Api Token
GET
List Emergency Clients
POST
Create Emergency Client
DELETE
Delete Emergency Client
GET
Get Emergency Client
POST
Regenerate Emergency Client
POST
Get Groups List
POST
Get Group Members List
GET
List O Auth Apps
POST
Create O Auth App
PUT
Update O Auth App
DELETE
Delete O Auth App
GET
Get O Auth App
POST
Rotate O Auth App Secret
DELETE
Delete Role Assignments
GET
Get Role Assignment
PUT
Update Role Assignment
POST
Get Users List
GET
Get Iam Task Details
GET
Get Eligible Vidbs
PATCH
Update Vidb Metadata