---
title: "PATCH /v4/workspaces/{workspaceId}/service-accounts/{id}"
method: PATCH
path: "/v4/workspaces/{workspaceId}/service-accounts/{id}"
tags: ["Workspace Identities"]
---

# PATCH /v4/workspaces/{workspaceId}/service-accounts/{id}

`PATCH /v4/workspaces/{workspaceId}/service-accounts/{id}`

## Request

- Base URL: `https://api.merkl.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.merkl.xyz/v4/workspaces/{workspaceId}/service-accounts/{id}`
- Auth: `apiKey` (a scheme the document does not define)

Rename, disable or re-enable a service account. Needs `service_account.manage` on it. Managing the credentials of a service account lets the holder act with that service account's rights.

## Path parameters

- `workspaceId` string, uuid, required
- `id` string, uuid, required

## Request body

- object
  - `name` string
  - `disabled` boolean

## Response `200`

Response for status 200

- object
  - `id` string, required
  - `name` string, required
  - `workspaceId` string, required
  - `disabled` boolean, required
  - `createdAt` string, required
  - `createdByUserId` string, nullable, required

## Changes

- **2026-10-22** `b32d82e3d5c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/merkl/apis/merkl-api/changes/v4/workspaces/:workspaceId/service-accounts/:id/patch.md)

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) - [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merkl/apis/merkl-api/revisions/60ffe2c7d887?raw)