---
title: "Rotate tenant OAuth client secret"
method: POST
path: "/v2/{tenant_slug}/tenants/rotate-auth-secret"
tags: ["Tenants"]
---

# Rotate tenant OAuth client secret

`POST /v2/{tenant_slug}/tenants/rotate-auth-secret`

Rotate a tenant OAuth client secret and return the new credentials.

## Path parameters

- `tenant_slug` string, required — Tenant DNS slug (lowercase letters, digits, and hyphens; 3-100 characters).

## Response `200`

Successful Response

- APIResponseTenantRotateAuthSecretResponse
  - `data` TenantRotateAuthSecretResponse, required
    - `client_id` string, required — OAuth 2.0 client identifier. Send this value as `client_id` when requesting a token from `POST /v2/oauth/token`.
    - `client_secret` string, required — Newly issued OAuth 2.0 client secret; the previous secret is invalidated immediately

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Request Validation Failed
- `500` — Internal Server Error
- `502` — Bad Gateway
- `503` — Service Unavailable

---

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