# Set a registration's credentials

> PUT /registrations/{registration_id}/credentials

Source: https://docs.trykintsugi.com/reference/2026-07-21/set-a-registration-s-credentials

PUT /registrations/{registration_id}/credentials

Set a registration's credentials

Set the stored sign-in credentials for a registration. Send a value for any of `username`, `password`, `pin`, `securityQuestions` to set it; a field you leave out (or send as `null`) is left unchanged. Sending `securityQuestions` replaces the stored set. Credentials are write-only: this returns the registration, never the values you sent, which are readable only through the credentials reveal endpoint.

Only an owner of the organization (or an API key scoped to it) may call it. Returns 404 if the registration does not exist or belongs to an organization your credential cannot access; 403 if your credential may read the organization but is not permitted to change credentials.

Category: Registrations

Path parameters:
registration_id (string, required) - The unique identifier of the registration.

Request body:
username (string) - Username for the jurisdiction's portal. Omit it or send `null` to leave the stored username unchanged. Write-only: reveal it through the credentials reveal endpoint.
password (string) - Password for the jurisdiction's portal, stored encrypted. Omit it or send `null` to leave the stored password unchanged. Write-only: reveal it through the credentials reveal endpoint.
pin (string) - PIN for the jurisdiction's portal, where one is used, stored encrypted. Omit it or send `null` to leave the stored PIN unchanged. Write-only: reveal it through the credentials reveal endpoint.
securityQuestions (PublicSecurityQuestion[]) - Security questions for the jurisdiction's portal, stored encrypted. Sending this replaces the stored set with the questions you send; omit it or send `null` to leave them unchanged. Write-only: reveal them through the credentials reveal endpoint.
  question (string, required) - The security question prompt shown by the jurisdiction portal.
  answer (string, required) - The answer to the security question. Write-only: reveal it through the credentials reveal endpoint.

Response fields:
id (string, required) - Kintsugi's unique identifier for the registration.
organizationId (string, required) - Organization the registration belongs to. Send it as `Organization-Id` to scope a request to this registration.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt
