---
title: "Update System Account"
method: PATCH
path: "/v3/system-accounts/{accountId}"
tags: ["System Accounts"]
---

# Update System Account

`PATCH /v3/system-accounts/{accountId}`

Updates the specified system account. Returns a 409 if the updated name is the same as another system account in the organization.

## Request body

- object
  - `name` string — Name of the system account.
  - `description` string — Description of the system account.

## Response `200`

A response including a single system account.

- SystemAccount — Schema of the system account.
  - `id` string, uuid — ID of the system account.
  - `name` string — Name of the system account.
  - `description` string — Description of the system account.
  - `created_at` string, date-time — Timestamp of when the system account was created.
  - `updated_at` string, date-time — Timestamp of when the system account was last updated.
  - `konnect_managed` boolean — The system account is managed by Konnect (true/false).

## Other responses

- `401` — Unauthenticated
- `403` — Unauthorized
- `404` — Not Found
- `409` — Conflict

## Changes

- **2025-10-30** `845120e19d45` — 2 breaking
  - the request property `description` became not nullable
  - the request property `name` became not nullable
- **2025-08-22** `3c0154b2053a` — 7 breaking, 2 info
  - the response property `description` became nullable for the status `200`
  - the response property `detail` became nullable for the status `403`
  - the response property `instance` became nullable for the status `403`
  - the response property `konnect_managed` became nullable for the status `200`
  - …5 more

[Change history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/system-accounts/:accountId/patch.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/7d3c634668f8/schema)