---
title: "Reset Credentials"
method: POST
path: "/v2/polaris/reset-credentials"
tags: ["Polaris"]
---

# Reset Credentials

`POST /v2/polaris/reset-credentials`

Reset a principal's credentials.

WARNING: new credentials are returned in the response body. Callers must
store them in a secrets manager immediately and not log the response.
TODO: migrate to writing directly to Vault/Secrets Manager and returning
only a reference ID to eliminate credential exposure over HTTP.

## Request body

- ResetCredentialsRequest
  - `principal_name` string, required
  - `client_id` string, nullable — Optional; if set, client_secret must also be set (Polaris reset body).
  - `client_secret` string, nullable — Optional; if set, client_id must also be set (Polaris reset body).

## Response `200`

Successful Response

- ResetCredentialsResponse
  - `principal_name` string, required
  - `client_id` string, required
  - `client_secret` string, required

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/revisions/fd615712e250/schema)