Sign in

v1

latestOpenAPI 3.0.3Apache 2.02026-07-2685172326.0 KB
Service Accounts

Update a service account

Update a service account's name; role bindings are managed through the role-binding endpoints.

patch/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

Request body

namestring

A new name for the service account. If omitted, the name is unchanged.

Example request

{
  "name": "ci-prod-renamed"
}

Response

Service account updated successfully.

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"
}