---
title: "Drop the service's cached copy of your venue credentials"
method: POST
path: "/credentials/invalidate"
tags: ["Exchanges"]
---

# Drop the service's cached copy of your venue credentials

`POST /credentials/invalidate`

## Request

- Base URL: `https://execution.kairos.trade`
- URL: `https://execution.kairos.trade/credentials/invalidate`
- Auth: API key in header `X-Client-Id` and API key in header `X-Api-Key` and API key in header `X-Api-Secret`

Evicts the cached credential set for one venue (or all of them) so the next order re-reads it from storage. Use after rotating a venue API key or re-running an enable-trading flow, when the executor would otherwise keep using the stale credential for the cache's lifetime.
Does not delete or modify any stored credential.
**Auth.** Authentication and self-ownership only — `user_id` must equal the authenticated caller. No scope is enforced and no mutation gate applies, so a bare session JWT is sufficient.

## Request body

- OrderCredentialsInvalidateRequest: Body for `POST /credentials/invalidate`.
  - `user_id` string, required: Must equal the authenticated caller's id — a mismatch is a `403`.
  - `exchange_id` string, nullable: Omit to invalidate the cached credentials for EVERY registered exchange. NOT canonicalized, so a deprecated alias such as `kalshi_offchain` may `404`.

## Response `200`

Cache evicted.

- OrderCredentialsInvalidateResponse
  - `success` boolean, required: Always `true` on the success path.

## Other responses

- `401`: No valid credential presented — missing/invalid API-key headers or an invalid/expired session token.
- `403`: `user_id` does not match the authenticated caller. Empty body (status code only).
- `404`: An `exchange_id` was supplied but no credential provider is registered for it. Empty body (status code only).

---

[API](https://skmtc.dev/kairos/apis/kairos-order-execution-api.md) - [All operations](https://skmtc.dev/kairos/apis/kairos-order-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kairos/apis/kairos-order-execution-api/revisions/9ba7d463d505?raw)