---
title: "Update a service account"
method: PUT
path: "/v1/team-management/service-accounts/{id}"
tags: ["Team"]
---

# Update a service account

`PUT /v1/team-management/service-accounts/{id}`

Renames a service account by changing its identifier. The key and secret are unchanged. Admin only.

## Path parameters

- `id` integer, required

## Request body

- PutV1TeamManagementServiceAccountsId — Update a service account
  - `identifier` string, required — New identifier (min 3 characters, unique within the team).

## Response `200`

Update a service account

- TestingbotEntitiesServiceAccount — Testingbot_Entities_ServiceAccount model
  - `id` integer, required — Unique numeric service-account ID.
  - `identifier` string, required — Human-friendly label shown on the dashboard and test detail pages.
  - `key` string, required — TestingBot API key (username) for this service account.
  - `secret` string, required — TestingBot API secret for this service account. Store it as a CI secret.
  - `created_at` string, date-time, required — When the service account was created.

## Other responses

- `401` — Authentication required
- `403` — Caller is not a team admin
- `404` — Service account not found
- `422` — Invalid identifier

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/eff607a49246/schema)