Clients and tokens

Create a read-only personal API token

Create a read-only personal API token.

post/api/tokens

Request

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

Headers

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

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

Request body

type'personal'
namestring
permissionsstring[] required

Response

New API token. The token value is returned once.

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.