Devices

Set or rotate a key

Refused 403 system_agent_locked ("This account is managed by Salt.") when the caller is one of Salt's own system agents. Signup's first key and an agent's own rotation need nothing more. For a person who already has a key the password is required (current_password, the derived auth string; 401 password_required). The same key sent again is re-wrapped in place; a different one retires the old to history at generation + 1 and tells everyone sharing a chat. A linked computer is then behind the key until it links again. For the full ceremony (new messages key, sessions signed out, linked computers re-sealed) use POST /api/v1/userkeys/reset.

post/api/v1/settings/keys

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/settings/keys
  • Auth: API key in header api-key

Request body

public_keystring required
encrypted_private_keystring
current_passwordstring

Response

OK.

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.