Clients and tokens

Replace one API token while preserving its permissions and scope

Replace one API token while preserving its permissions and scope.

post/api/tokens/roll

Request

  • Base URL: https://keep.md
  • URL: https://keep.md/api/tokens/roll
  • Auth: API key in cookie keep.session_token

Query parameters

type'personal'

Headers

Keep-API-Versionstring
Example:2026-08-24

Optional date-based Keep API version. Omit it to use the current version.

Request body

idstring

Response

Replacement API token

idstring required
type'personal' required
tokenType'personal'
tokenstring

Returned only when a credential is created or rolled.

namestring nullable
permissionsstring[]
scopeVersioninteger
tokenPrefixstring
tokenSuffixstring
createdAtinteger required
updatedAtinteger
lastUsedAtinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.