---
title: "aid_auths_clients_id_rotate_post"
method: POST
path: "/accounts/{oid}/auth/clients/{id}/rotate-secret"
tags: ["clients"]
---

# aid_auths_clients_id_rotate_post

`POST /accounts/{oid}/auth/clients/{id}/rotate-secret`

## Request

- Base URL: `https://api.dintero.com/v1`
- URL: `https://api.dintero.com/v1/accounts/{oid}/auth/clients/{id}/rotate-secret`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/dintero/apis/account-management-api/docs/accounts/:oid/auth/clients/:id/rotate-secret/post.ts> (a function with typed inputs; its response is checked against the schema)

Rotate a client secret.

scopes:
- admin:accounts
- write:accounts

## Path parameters

- `oid` string, ^[PT]{1}(?=(?:.{3}|.{8})$)[0-9]*$, required
- `id` string, required

## Response `200`

Client with secret

- object
  - `id` string, uuid: An UUID that uniquely identifies the resource
  - `created_at` string, date-time: The date-time when the resource was created
  - `created_by` string: The ID of the user/client created the resource
  - `updated_at` string, date-time: The date-time when the resource was last updated
  - `deleted_by` string: The ID of the user/client created the resource
  - `deleted_at` string, date-time
  - `name` string
  - `description` string
  - `client_id` string: Your client ID.
  - `callbacks` string[]
  - `client_secret` string

## Other responses

- `400`: Bad / Invalid request
- `401`: Access forbidden, invalid JWT token was used
- `403`: Forbidden
- `404`: Resource was not found
- `500`: Unexpected Error

---

[API](https://skmtc.dev/dintero/apis/account-management-api.md) - [All operations](https://skmtc.dev/dintero/apis/account-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dintero/apis/account-management-api/revisions/9b83a4199008?raw)