---
title: "Update a service account"
method: PATCH
path: "/orgs/{orgId}/service-accounts"
tags: ["Service Account", "experimental"]
---

# Update a service account

`PATCH /orgs/{orgId}/service-accounts`

Updates a service account's display name and/or description within the specified organization.

#### Scopes
**[OAuth 2.0 scopes](/cloud/admin/scopes/) required:** `write:service-accounts:admin`

## Path parameters

- `orgId` string, required

## Request body

- UpdateServiceAccountRequest
  - `atlassianId` string, required — The Atlassian account ID of the service account to update.
  - `displayName` string — The updated display name for the service account.
  - `description` string — The updated description for the service account.

## Response `200`

Returned if the service account is successfully updated.

- ServiceAccount — Represents a service account.
  - `atlassianId` string, required — The Atlassian account ID of the service account.
  - `id` string, required — The unique identifier of the service account. Same value as `atlassianId`.
  - `email` string — The email address of the service account.
  - `displayName` string, required — The display name of the service account.
  - `picture` string, nullable — The URL of the service account's avatar image.
  - `container` string — The ARI of the organization the service account belongs to. e.g. `ari:cloud:platform::org/{orgId}`
  - `updatedAt` integer — The timestamp (in milliseconds since epoch) when the service account was last updated.
  - `status` string, required — The status of the service account.
  - `createdById` string, nullable — The account ID of the user who created the service account.
  - `description` string, nullable — The description of the service account.

## Other responses

- `400` — Returned if the request is not in the correct format.
- `403` — Returned if the user does not have permission to update service accounts.
- `404` — Returned if the specified service account is not found.
- `500` — Internal Error

---

[API](https://skmtc.net/atlassian/apis/api-access.md) · [All operations](https://skmtc.net/atlassian/apis/api-access/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/api-access/revisions/412d18f78d91/schema)