Rotation
- Ask Tera to issue a new credential in the same environment with the scopes you need.
- Store the new secret. It is shown once.
- Switch your integration to the new
Authorizationvalue. - Ask Tera to revoke the previous public credential id.
Revocation
Revoke immediately if a secret may have leaked. A revoked key returns 401. In-flight requests already accepted are not undone; poll thosesubmission_ids as usual.
Tera stores a public credential id plus a keyed HMAC of the secret. Plaintext cannot be recovered after first display.
Environment isolation
- Rotate sandbox and production independently.
- A revoked sandbox key does not affect production, and the reverse.
- After revoke, issue a new key rather than asking Tera to “resend” the old secret.
What to send Tera
Quote the public credential id, environment, and theX-Request-Id response header of any failing call. Do not paste the secret into email or chat.