# Update a service account

**PATCH** `/admin/service-accounts/{service_account_id}`

:::code-group
```bash title="cURL"
curl --request PATCH \
  --url https://api.pinecone.io/admin/service-accounts/{service_account_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "ci-prod-renamed"
}'
```

```json title="200"
{
  "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"
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Path Parameters

- `service_account_id` (path, string, required) — The unique identifier of the service account.

## Headers

- `X-Pinecone-Api-Version` (header, string, required) — Required date-based version header

## Body

- `name` (body, string) — A new name for the service account. If omitted, the name is unchanged.

## Response

- `200` — Service account updated successfully.
- `400` — Bad request. The request body included invalid request parameters.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error.
- `4XX` — Unexpected error on request.

## Related pages

- [List service accounts](./admin-2-2026-07-admin-service-accounts-list-service-accounts.md)
- [Create a service account](./admin-2-2026-07-admin-service-accounts-create-a-service-account.md)
- [Get service account details](./admin-2-2026-07-admin-service-accounts-get-service-account-details.md)
- [Delete a service account](./admin-2-2026-07-admin-service-accounts-delete-a-service-account.md)
- [Rotate a service account's OAuth client secret](./admin-2-2026-07-admin-service-accounts-rotate-a-service-accounts-oauth-client-secret.md)
- [Create a service account](./admin-2-2026-04-admin-create-service-account.md)
- [List service accounts](./admin-2-2026-04-admin-list-service-accounts.md)
- [Get service account details](./admin-2-2026-04-admin-fetch-service-account.md)
- [Update a service account](./admin-2-2026-04-admin-update-service-account.md)
- [Delete a service account](./admin-2-2026-04-admin-delete-service-account.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.