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}

curl

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PINECONE_SERVICE_ACCOUNT_ID="YOUR_SERVICE_ACCOUNT_ID"

curl -X PATCH "https://api.pinecone.io/admin/service-accounts/$PINECONE_SERVICE_ACCOUNT_ID" \
	-H "X-Pinecone-Api-Version: 2026-04" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-d '{
		"name": "ci-prod-renamed"
	}'

curl

{
  "id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "name": "ci-prod-renamed",
  "client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
  "created_at": "2026-04-10T15:23:00Z",
  "updated_at": "2026-04-12T09:11:00Z"
}

curl

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PINECONE_SERVICE_ACCOUNT_ID="YOUR_SERVICE_ACCOUNT_ID"

curl -X PATCH "https://api.pinecone.io/admin/service-accounts/$PINECONE_SERVICE_ACCOUNT_ID" \
	-H "X-Pinecone-Api-Version: 2026-04" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-d '{
		"name": "ci-prod-renamed"
	}'

curl

{
  "id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "name": "ci-prod-renamed",
  "client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
  "created_at": "2026-04-10T15:23:00Z",
  "updated_at": "2026-04-12T09:11:00Z"
}

Authorizations

Authorization · string · header · required

An access token must be provided in the Authorization header using the Bearer scheme.

Headers

X-Pinecone-Api-Version · string · default: 2026-04 · required

Required date-based version header

Path Parameters

service_account_id · string<uuid> · required

The unique identifier of the service account.

Body

application/json

Updated metadata for the service account.

name · string

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

Required string length: 1 - 80

Example:

"ci-prod-renamed"

Response

200

application/json

Service account updated successfully.

A service account. The OAuth client_secret is not included.

id · string<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.

name · string · required

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

Required string length: 1 - 80

client_id · string · required

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

created_at · string<date-time> · required

The date and time the service account was created.

updated_at · string<date-time> · required

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