v1

latestOpenAPI 3.0.3Apache 2.02026-07-2685172326.0 KB

Service Accounts

Get service account details

Get a service account by ID; the client secret is returned only from create and rotate-secret requests.

get/admin/service-accounts/{service_account_id}

Path parameters

service_account_idstring uuid required

The unique identifier of the service account.

Headers

X-Pinecone-Api-Versionstring required

Required date-based version header

Response

The service account details (without the client secret). Role bindings are not included; use GET /admin/role-bindings to list them.

idstring uuid required

The unique identifier for the service account. Use this as the path parameter on /admin/service-accounts/{service_account_id} endpoints and as the principal_id when querying or creating role bindings.

namestring required

A short human-readable label, set by the caller at creation time.

client_idstring required

The OAuth client ID used by the service account to obtain access tokens. Used only for OAuth token exchange.

created_atstring date-time required

The date and time the service account was created.

updated_atstring date-time required

The date and time of the service account's most recent metadata update.

Example response

{
  "client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
  "created_at": "2026-04-10T15:23:00.000Z",
  "id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "name": "My Service Account",
  "updated_at": "2026-04-12T09:11:00.000Z"
}