# Update

Launch stage: Beta

`PATCH /api/2.0/identity/accounts/{account_id}/service-principals/{service_principal_id}`

Updates an existing service principal in the <Databricks> account. Only the fields named in the
 update mask are modified. Returns the updated ServicePrincipal resource.

 When AIM is enabled and the service principal is an external identity (its external_id is set),
 only external_id can be updated; its other fields are sourced from your identity provider.

API scopes: identity

## Path parameters

- `account_id` (string, optional)
  Required. The account ID for which the service principal is being updated.
- `service_principal_id` (string, optional)
  Required. Internal ID of the service principal in <Databricks>.

## Query parameters

- `update_mask` (string, optional)
  Optional. The list of fields to update.

## Request body

- `service_principal` (object, optional)
  Required. Service Principal to be updated in <Databricks>
  - `account_id` (string, optional)
    The parent account ID for the service principal in <Databricks>.
  - `service_principal_id` (string, optional)
    Internal service principal ID of the service principal in <Databricks>.
  - `external_id` (string, optional)
    ExternalId of the service principal in the customer's IdP.
  - `application_id` (string, optional)
    Application ID of the service principal. Set at creation time and cannot be changed
     afterwards; when omitted, the server generates one.
  - `display_name` (string, optional)
    Display name of the service principal.
  - `account_sp_status` (string, optional)
    The activity status of a service principal in a <Databricks> account.
    Possible values: `STATE_UNSPECIFIED`, `ACTIVE`, `INACTIVE`

## Returns

Returns the ServicePrincipal object.

## Response

```json
{
  "account_id": "string",
  "service_principal_id": "string",
  "external_id": "string",
  "application_id": "string",
  "display_name": "string",
  "account_sp_status": "string"
}
```