---
title: "Upsert service-principal classification config"
method: PUT
path: "/api/v1/databricks/users/service-principal-config"
tags: ["DATABRICKS", "Databricks", "Databricks Users"]
deprecated: true
---

# Upsert service-principal classification config

`PUT /api/v1/databricks/users/service-principal-config`

> **Deprecated.**

Save the prefix/regex patterns used to classify Databricks service principals.

Replaces any existing config. Invalid regexes are rejected at validation time.

## Headers

- `x-tenant` string, required

## Request body

- DatabricksServicePrincipalConfig — Tenant-configured patterns for classifying service-principal identities. The built-in application-id UUID rule is always applied in addition to these. An identity is treated as SERVICE_PRINCIPAL if it matches the UUID pattern, starts with any of ``prefixes``, or fully matches any of ``regexes``.
  - `prefixes` string[] — Identifier prefixes (e.g. 'svc', 'sa_') that mark a service principal.
  - `regexes` string[] — Regexes (RE2-compatible) that mark a service principal. The same pattern runs in Python `re` and ClickHouse `match()`, so RE2-only-incompatible syntax (lookaround, backreferences, possessive quantifiers) is rejected. Should be self-anchored if exact match is desired.

## Response `200`

Successful Response

- DatabricksServicePrincipalConfig — Tenant-configured patterns for classifying service-principal identities. The built-in application-id UUID rule is always applied in addition to these. An identity is treated as SERVICE_PRINCIPAL if it matches the UUID pattern, starts with any of ``prefixes``, or fully matches any of ``regexes``.
  - `prefixes` string[] — Identifier prefixes (e.g. 'svc', 'sa_') that mark a service principal.
  - `regexes` string[] — Regexes (RE2-compatible) that mark a service principal. The same pattern runs in Python `re` and ClickHouse `match()`, so RE2-only-incompatible syntax (lookaround, backreferences, possessive quantifiers) is rejected. Should be self-anchored if exact match is desired.

## Other responses

- `422` — Validation Error

---

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