k0rdent AI Docs

List service account credentials

Visibility: public · internal ( OpenAPI Custom Extension: x-visibility )

List credentials for a service account. Only tenant administrators can access this endpoint. The client_secret is never included in list responses.

GET
/v1/regions/global/iam/service-accounts/{serviceAccountId}/credentials

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token authentication using OAuth2/OIDC tokens

In: header

Path Parameters

serviceAccountId*string

Service account resource identifier.

Query Parameters

status?string

Filter credentials by status.

Value in"active" | "expired"
pageToken?string

Opaque cursor token returned in the previous response's nextPageToken. Pass to retrieve the next page of results.

Use for: Frequently updated resources (sessions, servers, clusters, API keys, instances, networks, addresses) where cursor pagination prevents items from being skipped or duplicated when the dataset changes between requests.

Mutually exclusive with offset — include one or the other, not both.

pageSize?integer

Maximum number of items to return per page. Applies to both cursor-based and offset-based pagination.

Range: 1–500. Default: 50.

Default50
Range1 <= value <= 500
offset?integer

Number of items to skip before returning results.

Use for: Stable resources that change infrequently (roles, organizations, providers, policies, groups, projects) where offset pagination enables page-number UIs and total-count displays.

When using offset, the response includes a total field with the full item count. Mutually exclusive with pageToken — include one or the other, not both.

Default0
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.k0rdent.ai/v1/regions/global/iam/service-accounts/string/credentials"
{
  "credentials": [
    {
      "selfLink": "/v1/iam/service-accounts/sa-pipeline-prod/credentials/cred-001",
      "uid": "07cc67f4-45d6-494b-adac-09b5cbc7e2b5",
      "id": "cred-001",
      "serviceAccountId": "sa-pipeline-prod",
      "status": "active",
      "expiresAt": "2019-08-24T14:15:22Z",
      "createdBy": "user-admin-001",
      "createdAt": "2019-08-24T14:15:22Z",
      "lastUsedAt": "2019-08-24T14:15:22Z",
      "lastUsedIp": "203.0.113.42"
    }
  ],
  "nextPageToken": "string",
  "total": 0
}
{
  "error": {
    "code": 0,
    "message": "string",
    "details": [
      {}
    ]
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "details": [
      {}
    ]
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "details": [
      {}
    ]
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "details": [
      {}
    ]
  }
}

How is this guide?

On this page

No Headings