Update Account Credential

​

Update an account credential -- rotate its PIN or toggle its active status, which reactivates a soft-deleted credential (pin and is_active are the only updatable fields). Authorization mirrors credential creation: an account can update its own credentials, and a parent (PSP/partner) can update a child account's credentials.

Path Parameters
  • credential_id
    Type: string · Credential Id
    required

    The ID of the credential to update

Headers
  • Accept
    enum
    const:  
    application/json
    required

    Response format. Must be application/json.

    values
    • application/json
  • Content-Type
    enum
    const:  
    application/json
    required

    Request payload format. Must be application/json when a body is sent.

    values
    • application/json
Body·
required
application/json
  • is_active
    Type: boolean | null · Is Active
  • pin
    Type: string | null · Pin
    min length:  
    6
    max length:  
    6
Responses
  • application/json
  • application/json
Request Example for put/v1/accounts/credentials/{credential_id}
curl 'https://api.uat.koard.com/v1/accounts/credentials/{credential_id}' \
  --request PUT \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'x-koard-apikey: YOUR_SECRET_TOKEN' \
  --data '{
  "is_active": null,
  "pin": null
}'

{
  "account_id": "string",
  "code": "string",
  "created_at": "2026-07-10T18:41:46.967Z",
  "deleted_at": null,
  "email": null,
  "firebase_uid": null,
  "id": "string",
  "is_active": true,
  "last_token_invalidated_at": null,
  "last_used_at": null
}

Successful Response