SECRET_ALREADY_EXISTS
409invalid_requestAn active secret already exists for this environment.
Cause
A client holds at most one active secret per environment, and plaintext is shown only once at creation.
How to fix it
Rotate the existing secret rather than creating a second one; rotation returns a fresh plaintext value.
Example response
409 SECRET_ALREADY_EXISTS
JSON
{
"error_code": "SECRET_ALREADY_EXISTS",
"error_type": "invalid_request",
"error_message": "An active secret already exists for this environment.",
"hint": "Rotate the existing secret rather than creating a second one; rotation returns a fresh plaintext value.",
"docs_url": "https://docs.billerapi.com/errors/SECRET_ALREADY_EXISTS",
"request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}Related
- Error handling — the error envelope shape and how to parse it
- Error code reference — every stable error code
Canonical docs URL: https://docs.billerapi.com/errors/SECRET_ALREADY_EXISTS
Was this page helpful?