---
title: "Update the details of a service account. Updating the details of the service account does not regenerate its keys."
method: PUT
path: "/v2/organizations/{organization}/serviceaccounts/{serviceaccount}"
tags: ["Teams"]
---

# Update the details of a service account. Updating the details of the service account does not regenerate its keys.

`PUT /v2/organizations/{organization}/serviceaccounts/{serviceaccount}`

## Request

- Base URL: `https://docs.tetrate.io` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.tetrate.io/v2/organizations/{organization}/serviceaccounts/{serviceaccount}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/docs/v2/organizations/:organization/serviceaccounts/:serviceaccount/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `organization` string, required
- `serviceaccount` string, required

## Request body

- object: `ServiceAccount` represents a service account that can be used to access the TSB platform. Service accounts have a set of associated public and private keys that can be used to generate signed JWT tokens that are suitable to authenticate to TSB. A default key-pair is generated on service account creation and the public key is stored in TSB. Private keys are returned when service accounts are created, but TSB will not store them. It is up to the client to store them securely.
  - `description` string: A description of the resource.
  - `displayName` string
  - `etag` string
  - `keys` ServiceAccountKeyPair[]
    - `id` string
    - `publicKey` string
    - `privateKey` string
    - `encoding` 'PEM' | 'JWK'
    - `defaultToken` string

## Response `200`

A successful response.

- Tsbv2ServiceAccount: `ServiceAccount` represents a service account that can be used to access the TSB platform. Service accounts have a set of associated public and private keys that can be used to generate signed JWT tokens that are suitable to authenticate to TSB. A default key-pair is generated on service account creation and the public key is stored in TSB. Private keys are returned when service accounts are created, but TSB will not store them. It is up to the client to store them securely.
  - `fqn` string
  - `displayName` string
  - `etag` string
  - `description` string: A description of the resource.
  - `keys` ServiceAccountKeyPair[]
    - `id` string
    - `publicKey` string
    - `privateKey` string
    - `encoding` 'PEM' | 'JWK'
    - `defaultToken` string

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api.md) - [All operations](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/revisions/2f19c3a1ae57?raw)