---
title: "PUT /public/v1/clusters/{clusterName}/service-accounts"
method: PUT
path: "/public/v1/clusters/{clusterName}/service-accounts"
tags: ["service-accounts"]
---

# PUT /public/v1/clusters/{clusterName}/service-accounts

`PUT /public/v1/clusters/{clusterName}/service-accounts`

## Request

- Base URL: `https://developers.conduktor.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developers.conduktor.io/public/v1/clusters/{clusterName}/service-accounts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-console-api/docs/public/v1/clusters/:clusterName/service-accounts/put.ts> (a function with typed inputs; its response is checked against the schema)

Put acl for a given service account

## Path parameters

- `clusterName` string, required

## Request body

- AllAclForPrincipal
  - `aclPrincipal` AclPrincipal, required
    - `type` string, required
    - `name` string, required
  - `acls` AclForResourceAndHost[]
    - `pattern` ResourcePattern, required
      - `resourceType` 'Unknown' | 'Topic' | 'Group' | 'Cluster' | 'TransactionalId' | 'DelegationToken' | 'User', required
      - `name` string, required
      - `patternType` 'Literal' | 'Prefixed', required
    - `host` string, required
    - `operationStates` OperationStates, required
      - `Unknown` 'Deny' | 'Allow'
      - `All` 'Deny' | 'Allow'
      - `Read` 'Deny' | 'Allow'
      - `Write` 'Deny' | 'Allow'
      - `Create` 'Deny' | 'Allow'
      - `Delete` 'Deny' | 'Allow'
      - `Alter` 'Deny' | 'Allow'
      - `Describe` 'Deny' | 'Allow'
      - `ClusterAction` 'Deny' | 'Allow'
      - `DescribeConfigs` 'Deny' | 'Allow'
      - `AlterConfigs` 'Deny' | 'Allow'
      - `IdempotentWrite` 'Deny' | 'Allow'
      - `CreateTokens` 'Deny' | 'Allow'
      - `DescribeTokens` 'Deny' | 'Allow'
      - `TwoPhaseCommit` 'Deny' | 'Allow'

## Response `200`

## Other responses

- `400`: Security disabled on this kafka cluster
- `401`: The user is not authenticated
- `403`: The user doesn't have the required permission(s) "kafka.clusters.acl.create, kafka.clusters.acl.delete" to do this operation
- `404`: No cluster with this technical id exist
- `500`: An unexpected error occurred in the server

---

[API](https://skmtc.dev/conduktor/apis/conduktor-console-api.md) - [All operations](https://skmtc.dev/conduktor/apis/conduktor-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conduktor/apis/conduktor-console-api/revisions/24750c294805?raw)